adoptopenjdk-getting-started-kit icon indicating copy to clipboard operation
adoptopenjdk-getting-started-kit copied to clipboard

A bit of an overlap (duplication) in documentation caused by linking to an external resource

Open neomatrix369 opened this issue 8 years ago • 4 comments

The front page of https://www.gitbook.com/book/adoptopenjdk/adoptopenjdk-getting-started-kit/details points to Click here for Quick Start Guide which is essentially already present in the existing guide, and there are no/or fewer backlinks to the main guide.

Readers might get lost in the navigation process, but its best to maintain on source rather than multiple pathways.

Look for sub-pages under https://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/en/ and in the Quick Start Guide and merge them wherever they overlap or fill the gaps. Which also means changing the English version means other pages of other languages will need an update as well.

Best person to chat with is @mikebgx for any questions about the Quick Start Guide.

neomatrix369 avatar May 18 '17 09:05 neomatrix369

Take a look at this one @allandequeiroz if you like, its been an issue since sometime

neomatrix369 avatar May 20 '17 10:05 neomatrix369

Great! I'll @neomatrix369, as soon I get back home

allandequeiroz avatar May 20 '17 11:05 allandequeiroz

Its also important all the document changes are tested out both the EN and PT versions - can you pls have your community contacts trial it out and report issues to us?

neomatrix369 avatar May 20 '17 12:05 neomatrix369

Sure, no problem, I've sent to some guys already, I'll catch up with them this week to see how they are progressing.

allandequeiroz avatar May 20 '17 12:05 allandequeiroz