Naming a 'read me' file people will actually read?

General discussion for players of Oolite.

Moderators: winston, another_commander

Would you open the file and read it?

Yeah, I'd be sure to read it first.
9
69%
Nah, you're being too subtle.
4
31%
 
Total votes: 13

User avatar
Wildeblood
---- E L I T E ----
---- E L I T E ----
Posts: 2453
Joined: Sat Jun 11, 2011 6:07 am
Location: Western Australia
Contact:

Naming a 'read me' file people will actually read?

Post by Wildeblood »

My new OXP can't just be dropped into AddOns like most. It will need people to actually read the instructions. Will this do the trick, or am I still being too subtle?

SERIOUSLY, read this BEFORE installing AI Trading Assistant to your AddOns folder.txt
User avatar
Cody
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
Posts: 16081
Joined: Sat Jul 04, 2009 9:31 pm
Location: The Lizard's Claw
Contact:

Re: Naming a 'read me' file people will actually read?

Post by Cody »

Make the OXP link only available on your Wiki page, and put the warning/instructions there in red/capitals!
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
User avatar
Diziet Sma
---- E L I T E ----
---- E L I T E ----
Posts: 6312
Joined: Mon Apr 06, 2009 12:20 pm
Location: Aboard the Pitviper S.E. "Blackwidow"

Re: Naming a 'read me' file people will actually read?

Post by Diziet Sma »

Alternatively, you could call it "Read this for your chance to win $50,000!" :lol:


Seriously though, I'd go with EV's suggestion. Hide the link at the bottom, in a much smaller font.
Most games have some sort of paddling-pool-and-water-wings beginning to ease you in: Oolite takes the rather more Darwinian approach of heaving you straight into the ocean, often with a brick or two in your pockets for luck. ~ Disembodied
User avatar
Svengali
Commander
Commander
Posts: 2370
Joined: Sat Oct 20, 2007 2:52 pm

Re: Naming a 'read me' file people will actually read?

Post by Svengali »

It has nothing to do with subtle or not. Ppl tend to go directly to the download link, quite a few of them won't even read anything (neither on the WIKI, nor readmes or posts on BB) if the name of the OXP sounds interesting and a download is available.

E.g. BGS states the requirement of CCL on its WIKI page, on box.net (only works if preview is enabled or the user is logged in), in the readme and if it's not installed in Latest.log and as onscreen message to check Latest.log. And still the questions will pop up from time to time. Answering these questions is part of releasing OXPs to the public.
User avatar
Eric Walch
Slightly Grand Rear Admiral
Slightly Grand Rear Admiral
Posts: 5536
Joined: Sat Jun 16, 2007 3:48 pm
Location: Netherlands

Re: Naming a 'read me' file people will actually read?

Post by Eric Walch »

Start the oxp with a question on a missionscreen, of which the answer is hidden in the read-me. Wrong choice and the oxp deletes itself. Preferably use a random mix of questions on every start, so they really have to learn it by hart. :twisted:

e.g.
Q: What must I always do
A: Start reading the read-me

Actually a bad example as people will intuitively know that A is the right choice. :D
User avatar
Svengali
Commander
Commander
Posts: 2370
Joined: Sat Oct 20, 2007 2:52 pm

Re: Naming a 'read me' file people will actually read?

Post by Svengali »

Eric Walch wrote:
Start the oxp with a question on a missionscreen, of which the answer is hidden in the read-me. Wrong choice and the oxp deletes itself.
But only after removing all equipment from the player ship and throwing players credits out of the window :twisted:
User avatar
Wildeblood
---- E L I T E ----
---- E L I T E ----
Posts: 2453
Joined: Sat Jun 11, 2011 6:07 am
Location: Western Australia
Contact:

Re: Naming a 'read me' file people will actually read?

Post by Wildeblood »

Eric Walch wrote:
Start the oxp with a question on a missionscreen, of which the answer is hidden in the read-me. Wrong choice and the oxp deletes itself. Preferably use a random mix of questions on every start, so they really have to learn it by heart. :twisted:

e.g.
Q: What must I always do
A: Start reading the read-me
Q: Did you have cargo in your hold?

"What does it mean, did I?"
JD
Deadly
Deadly
Posts: 182
Joined: Thu Nov 25, 2010 10:42 pm
Location: London, UK

Re: Naming a 'read me' file people will actually read?

Post by JD »

Could you make it a piece of purchasable equipment, which can't be bought unless the hold is empty? (Not sure whether that's actually feasible or not.) Or alternatively, the trading assistant doesn't enable itself and start tracking until the first occasion when the hold is empty?
User avatar
Wildeblood
---- E L I T E ----
---- E L I T E ----
Posts: 2453
Joined: Sat Jun 11, 2011 6:07 am
Location: Western Australia
Contact:

Re: Naming a 'read me' file people will actually read?

Post by Wildeblood »

JD wrote:
Could you make it a piece of purchasable equipment, which can't be bought unless the hold is empty? (Not sure whether that's actually feasible or not.)
Trading Assistant is purchased equipment, but the data logging runs continuously, so it isn't interrupted if the equipment is damaged.
JD wrote:
Or alternatively, the trading assistant doesn't enable itself and start tracking until the first occasion when the hold is empty?
That was my first thought, but you get these eccentric players who hoard the precious metals and never sell them, so their manifest will never be completely empty.
It's just a matter of selling their hoard, saving their game, installing the OXP, then buying back what they sold; since they'd be buying it at the same price they sold it it wouldn't affect their progress in the game at all. In the end I have to credit people with enough common sense to understand that, I suppose. :roll:
User avatar
Thargoid
Thargoid
Thargoid
Posts: 5528
Joined: Thu Jun 12, 2008 6:55 pm

Re: Naming a 'read me' file people will actually read?

Post by Thargoid »

You could do that silently and automatically by script with a MV flag set to make it a one-time only event.
User avatar
Wildeblood
---- E L I T E ----
---- E L I T E ----
Posts: 2453
Joined: Sat Jun 11, 2011 6:07 am
Location: Western Australia
Contact:

Re: Naming a 'read me' file people will actually read?

Post by Wildeblood »

Yeah, now that I think about it... I was assuming it would take hundreds of lines of faffing about to idiot-proof it, but it's really only a matter of copying the current manifest into the purchase log, assuming it was bought at the current station and using its prices to pre-set the ledgers... End of thinking out loud.

It's still one-time-only faffing about for the benefit of lazy gits, though, so I'll put it on the list of things to add, but not at the top.
User avatar
Cody
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
Posts: 16081
Joined: Sat Jul 04, 2009 9:31 pm
Location: The Lizard's Claw
Contact:

Re: Naming a 'read me' file people will actually read?

Post by Cody »

Wildeblood wrote:
It's still one-time-only faffing about for the benefit of lazy gits...
The 'lazy gits', as you call them, are only the end-users... why worry about them, eh?
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
User avatar
Diziet Sma
---- E L I T E ----
---- E L I T E ----
Posts: 6312
Joined: Mon Apr 06, 2009 12:20 pm
Location: Aboard the Pitviper S.E. "Blackwidow"

Re: Naming a 'read me' file people will actually read?

Post by Diziet Sma »

Wildeblood wrote:
It's still one-time-only faffing about for the benefit of lazy gits, though, so I'll put it on the list of things to add, but not at the top.
Heck.. why bother sanity-checking input, then? It's only those too lazy to double-check their typing who'll be affected.
:roll: :roll: :roll: :roll: :roll:
Most games have some sort of paddling-pool-and-water-wings beginning to ease you in: Oolite takes the rather more Darwinian approach of heaving you straight into the ocean, often with a brick or two in your pockets for luck. ~ Disembodied
User avatar
Tricky
---- E L I T E ----
---- E L I T E ----
Posts: 821
Joined: Sun May 13, 2012 11:12 pm
Location: Bradford, UK. (Anarchic)

Re: Naming a 'read me' file people will actually read?

Post by Tricky »

El Viejo wrote:
Wildeblood wrote:
It's still one-time-only faffing about for the benefit of lazy gits...
The 'lazy gits', as you call them, are only the end-users... why worry about them, eh?
"Software is idiot proof so long as idiots (end-users) don't use it."

:lol:
User avatar
Eric Walch
Slightly Grand Rear Admiral
Slightly Grand Rear Admiral
Posts: 5536
Joined: Sat Jun 16, 2007 3:48 pm
Location: Netherlands

Re: Naming a 'read me' file people will actually read?

Post by Eric Walch »

Tricky wrote:
"Software is idiot proof so long as idiots (end-users) don't use it."
And you can make it to much idiot proof. I remember a digital tax form were the user was forced to only fill in positive numbers in certain fields. Than they changed the law a bit, with as result that in some occasions the number could become negative. When I called them, they said that they knew the problem, and I should fill in my negative number in an other field that allowed negative numbers. The addition stayed the same, but I now declared a completely wrong point.
Similar happened a year were I had to fill in that my business was a farm! I called the help desk and indeed, they told me that is was written in big letters on a blackboard at their help desk that in occasions similar to mine, an agrarian profession had to be filled in. When I filled in the correct profession it would go wrong further down in the tax form.

So far foolproof forms that restrict your input to 'legal' values. :(
Post Reply