[forge-issues] [JBoss JIRA] (FORGE-2637) Documentation Updates

[George Gastaldi (JIRA)]

    [ https://issues.jboss.org/browse/FORGE-2637?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13189921#comment-13189921 ] 

George Gastaldi commented on FORGE-2637:
----------------------------------------

Hi [~remmeier],

Thank you for your feedback. They are really important. 
I am thinking of  working on a JBoss Forge Users Guide and publishing it on https://www.gitbook.com (with a Github repository to allow easier contributions).
I'd love to know what the community thinks about the beginner/intermediate/advanced labels. Would you mind posting a message in our user forums and ask for feedback(https://developer.jboss.org/en/forge) ? 

Once again, thank you very much!


> Documentation Updates
> ---------------------
>
>                 Key: FORGE-2637
>                 URL: https://issues.jboss.org/browse/FORGE-2637
>             Project: Forge
>          Issue Type: Feature Request
>            Reporter: Remo Meier
>
> Jboss Forge looks very good from a technical perspective (thanks for all the work!). Documentation and maybe reach within the Java community could be a bit better. Maybe the former could help with the later. Here are just a few suggestions:
> 1. I found that the old documentation (1.1.x) gives a much better overview in writing a plugin (explains things like Facets). That should be integrated into the new documentation.
> 2. There are tutorials on Youtube, make sure to link them.
> 3. Website is sometimes a bit inefficient with spacing. Panels take away a lot of space. e.g. the news page. And please get rid of those beginner/intermediate/advanced labels...
> 4. A lot of things are "hidden" in the hands on lab, like the command reference.
> 5. Currently it is more of a collection of tutorials (sometimes with repeated content). I kind of miss the  "one" documentation of Forge. To get an idea, have for exmple a look at the Spring Boot documentation.



--
This message was sent by Atlassian JIRA
(v6.4.11#64026)