jetty / jetty.website

Antora-based jetty.org website.
https://jetty.org
Eclipse Public License 2.0
1 stars 3 forks source link

Update Documentation page #59

Closed jmcc0nn3ll closed 2 weeks ago

jmcc0nn3ll commented 2 weeks ago

Factor in the changes from:

https://github.com/jetty/jetty.project/pull/12194

jmcc0nn3ll commented 2 weeks ago

@sbordet this is feeling awkward...It is too easy to duplicate the content on this page with what you put on the jetty 12 root page.

As it stands the content on this page really thin and if we remove the split links to the operations guide and the programming guide it will be even thinner.

I think it could move the content from that root page in 12 to here, or we make this link and page just direct to the jetty 12 one.

I think my preference would be to move that content from 12 doc root here and have this page continue linking directly to the various guide versions....

thoughts?

sbordet commented 2 weeks ago

As it stands the content on this page really thin and if we remove the split links to the operations guide and the programming guide it will be even thinner.

That's the goal.

I want as much as possible in the documentation.

The website pages should just be a small glue that points to the documentation.

jmcc0nn3ll commented 2 weeks ago

In principle, yes, but this page is just a thin extra click-through page, which I think we want to avoid.

I'll do the basic we talked about and see how it looks.

jmcc0nn3ll commented 1 week ago

deployed