Go Back   Angband Forums > Angband > Vanilla

Thread Tools Display Modes
Old June 20, 2020, 04:49   #1
Join Date: Oct 2018
Posts: 9
chandergovind is on a distinguished road
Any reason for removing in-game docs in 4.2?

I upgraded recently from 4.1.x and am sorely feeling the lack of the in-game docs.

As an intermediate player, I need to often look-up stuff, for example, the structure of the inscriptions. I even learnt about keymaps originally while going through the docs in the middle of playing.

I also suspect that the character creation experience for a new player would feel a lot more mechanical. I used to, and still do, go through the docs of the races/classes when rolling a new char.

Am I the only one feeling this? Is there some compile option I can use to bring it back?
chandergovind is offline   Reply With Quote
Old June 21, 2020, 16:09   #2
Join Date: Oct 2016
Location: London-ish
Age: 50
Posts: 2,159
Sky will become famous soon enough
there is an online google doc now that has far more info:
"i can take this dracolich"
Sky is offline   Reply With Quote
Old June 21, 2020, 22:23   #3
Vanilla maintainer
Nick's Avatar
Join Date: Apr 2007
Location: Canberra, Australia
Age: 57
Posts: 9,480
Donated: $60
Nick will become famous soon enoughNick will become famous soon enough
The general idea was that they were not that easy to read, and people tended not to look at them. They are all available (updated to the lateest version) here.
One for the Dark Lord on his dark throne
In the Land of Mordor where the Shadows lie.
Nick is offline   Reply With Quote
Old June 22, 2020, 15:26   #4
Join Date: Oct 2018
Posts: 9
chandergovind is on a distinguished road
@Sky, wasn't aware of this sheet. Seems pretty detailed.

@Nick, was aware of this link - the in-game help does redirect one to it. If the general consensus points to people not using the in-game version, that's fine I guess.

I still think that retaining some version of this in-game, at least the race/class related stuff, will be useful for newcomers, but maybe that's just my own biased preference.
chandergovind is offline   Reply With Quote
Old June 22, 2020, 16:03   #5
Join Date: Apr 2009
Location: Pisa / DL0
Posts: 1,023
fph is on a distinguished road
For what it's worth, I like the idea of moving the help online. The in-game reader was clunky and limited, and everyone can open a browser these days. Many modern games do not have in-game help (I believe that those who do are a minority), and young people are trained to look online for help.
I worked in the past on the help files and browser (and I am in part responsible for why it was clunky and limited), and I am happy to see it gone for a better system.

The only thing I am unsure about is how this new system handles different versions of the game. Does the in-game help always point to the "latest" version on readthedocs? If some features are changed between one version and the other, even if the help files are updated in the source tree, the game is going to point readers to the wrong version of the help files. Maybe the official build for version 4.2.1 should point to (a page that does not exist currently), and so on.
Dive fast, die young, leave a high-CHA corpse.
You read a scroll labeled 'lol gtfo' of Teleport Level.
fph is offline   Reply With Quote
Old June 25, 2020, 18:41   #6
Archenoth's Avatar
Join Date: May 2020
Posts: 26
Archenoth is on a distinguished road
I miss the in-game docs too since I play on devices where switching tasks isn't exactly seamless, and sometimes even on things without a browser. (Or where a browser would drain a battery more than a simple terminal would)

That said, I can understand that they add more maintenance overhead, and I'm very much in the minority when it comes to how I play, so I've just copied over the help files from old versions into the right places to not make more work for whoever would need to keep these files up to date.

If you want to do that too, basically, if you copy the text files from here into your help folder, the game can understand them normally. (Though note that some of the things in these files is out of date)
Archenoth is offline   Reply With Quote

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Wizard mode docs? CunningGabe Vanilla 11 January 8, 2020 02:42
in-game help docs? icefyre Vanilla 0 December 27, 2019 04:34
removing lava Estie Vanilla 2 September 20, 2017 13:40
Fascinating Crawl Code and Docs Wiki half Idle chatter 4 February 11, 2014 08:17
Is there a good reason there's no iOS port? modusgolems Development 4 December 31, 2013 04:27

All times are GMT +1. The time now is 02:40.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2023, vBulletin Solutions Inc.