search

triplea-game / triplea-game.github.io

TripleA Website
https://triplea-game.org/
GNU Affero General Public License v3.0
12 stars 16 forks source link

/user-guide/first-turn-walkthrough needs review #346

Closed tvleavitt closed 2 years ago

tvleavitt commented 4 years ago

Verbiage, and specifically screenshots included in this document should be reviewed for congruence with 2.0.

https://triplea-game.org/user-guide/first-turn-walkthrough

DanVanAtta commented 4 years ago

The manual was out of date when 1.9 was released. We can also update it roughly anytime, there should not be a 2.0 dependency. Also 2.0 will continue to have more releases to it perhaps weekly/monthly (it's not going to be the latest for 18 months like 1.9.0.0.13066 was). Considering the document is already live as well, this is a current problem.

tvleavitt commented 4 years ago

Honestly, my opinion is that either content is current and accurate, or it goes away... or at least prominent disclaimers about details being out of date are included. It looks bad. All content should have an assigned "owner", if no one is willing to take responsibility for updating it, it should be taken down as soon as it goes out of date.

Thomas Leavitt

On Sat, May 16, 2020, 4:13 PM Dan Van Atta notifications@github.com wrote:

The manual was out of date when 1.9 was released. We can also update it roughly anytime, there should not be a 2.0 dependency. Also 2.0 will continue to have more releases to it perhaps weekly/monthly (it's not going to be the latest for 18 months like 1.9.0.0.13066 was). Considering the document is already live as well, this is a current problem.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/triplea-game/triplea-game.github.io/issues/346#issuecomment-629717985, or unsubscribe https://github.com/notifications/unsubscribe-auth/ABB5HAMJ7SNFCCEM2YMIOCTRR4MX7ANCNFSM4NDDHJ2A .

DanVanAtta commented 4 years ago

I do not necessarily disagree. There have been a lot of problems with documentation over the lifetime of this project. Notably we have never really had a centralized location for it, duplicative documentation written by individuals and then often not maintained. We still have a lot of content to bring in from the forums to the website. More attention would be welcome and could be payed to any documentation on the website (and more consolidation), any help we can get is very welcome.