The "let's improve the OOTP manual" thread
Hello OOTP Citizens:
I now have access to edit the OOTP 14 manual. I have some manual writing experience for Nuance and Freeverse, along with some related experience for Apple, so I said I'd jump in and help improve the manual where I could. I know I've seen comments along the lines of "This isn't documented properly in the manual," or "This should be in the manual," so I'd like to use this thread for everyone to post what they'd like to see in the manual. What do we need to add? What do we need to change? I realize there's probably a lot of work to be done here, but if I start with the big stuff and do what I can here and there in between my other duties, maybe we can whip this into shape in time for OOTP 15. Thanks! - Brad |
Would you be able to take submissions in typical word processing formats ie Microsoft Office and put them in the manual? If you can, I may be able to help out. I have considerable experience writing technical documentation, specifications, work instructions etc.
|
One obvious place to start is the manual's section on storylines, the entire content of which is "no content yet."
|
Great Idea.
Might I suggest a look at both the Pitching Staff and Lineups pages. They no longer relate to 14 with the improvements over previous versions. And, now that you've asked, I'll have a look for other items. Good luck with the project. |
Wiki?
Have you considered making the manual a wiki? That way established members of the community could help edit the manual to make sure things that aren't covered are.
|
Quote:
/fail My two bits: ask here and in the newbie forum what people have the most trouble understanding in the game and do those first. It makes more sense to me than updating stuff that's intuitive. |
Quote:
You can write new manual pages in MS Word. But they would have to be converted into HTML. MS Word uses special characters for quotation marks and dashes which would need to be converted. If I would have to do it, I would copy the whole text from MS Word into an editor like notepad.exe. Then I would manually insert br tags for every line break and all the other tags. Tables are some extra work. It's doable, but obviously it would be much better to write HTML code instead of using MS Word. To see which HTML tags we're using for the manual pages, open them in the browser and use the "View page source code" feature of the browser. This is a list of the tags: h5 for head lines a for links table, tr, td for tables p for paragraphs. Do not use div! b for bold and i for italic ol, ul, li for lists img for images Thanks for any help! It's much appreciated :thumbup1: |
Quote:
|
I also have some documentation experience and am happy to help out. One thing that immediately springs to mind is how dated a lot of the screenshots are. I can go through it over the holidays and make a list of screenshots that need updating.
|
Quote:
http://www.ootpdevelopments.com/boar...al-thread.html (I believe this thread is still somewhat to mostly accurate in its observations) http://www.ootpdevelopments.com/boar...ed-manual.html http://www.ootpdevelopments.com/boar...pleteness.html Also, please see this post from a well-meaning soul whose ambitious thread unfortunately devolved into stuff and nonsense; he mentions three blank pages in the online manual: http://www.ootpdevelopments.com/boar...57-post41.html |
Quote:
|
Will do!
|
This is great news! My recommendation for OOTP 15 was to have a more thorough game manual. Thanks for making the game even better!
Jason ABL Commissioner ADULT BASEBALL LEAGUE :: ADULT BASEBALL LEAGUE |
I am not sure how many other OOTP members would agree with this idea however, I think it would be great if OOTP created and published a PDF version of the game manual.
If my memory serves me correctly a PDF game manual has not been available since OOTP9 and alot has changed since then. I feel that a updated PDF manual would make a real nice asset to this series since currently the only way to view the manual is for a game owner to be connected to the internet. |
Quote:
|
If we had a tool which would convert hundreds of HTML pages into a PDF file, we would do it. I made two attempts to convert the HTML pages into PDF and tried several both free and commercial tools, but I was not able to automate the process :(
I could add a feature to the online manual database which generates a single HTML page containing the whole manual in the right order of pages. All the headlines are structured using h2, h3, h4 (and so on) tags, so a tool could easily generate an index with links to the sections... |
Quote:
Quote:
Quote:
|
I agree with updating the manual. It does need updating. I would offer to help but i havent got around to actually reading it yet. :)
|
Now is the time to move ahead on this project because OOTPB 15 has been announced with even more features to be documented. We don't want to fall too far behind.
|
We need to make sure the SCOUTING area shows what other other options need to be chosen in order for it to work effectively.
One thing I stumbled upon is you need to click create and maintain hidden players so your scout has something to go out and look for |
All times are GMT -4. The time now is 05:30 AM. |
Powered by vBulletin® Version 3.8.10
Copyright ©2000 - 2024, vBulletin Solutions, Inc.
Copyright © 2020 Out of the Park Developments