On 2 February 2018 at 17:41, Oleg Kalnichevski <[email protected]> wrote: > On Fri, 2018-02-02 at 17:05 +0000, sebb wrote: >> On 2 February 2018 at 13:33, Oleg Kalnichevski <[email protected]> >> wrote: >> > On Wed, 2018-01-31 at 20:18 +0000, sebb wrote: >> > > It may not be pretty, but I find it legible and generally easy to >> > > navigate so I hope those attributes won't be lost. >> > > >> > > Also, it's important not to break any links. >> > > >> > >> > It is also important to eat healthy, be polite and stay away from >> > those >> > girls. >> > >> > I am sorry, Sebastian, but links are likely to get broken and some >> >> It's not necessary to change the site design. >> Nor is it necessary to drop Maven. >> > > Of course not, as long as some other poor sucker has to maintain that > site. > >> I think links are a lot more more important than looks. >> > > This is not so much about the look of the site being terrible (which is > a consequence, not a cause) but about the way the site gets generated > is terrible.
In what way is it terrible? And does that have anything to do with Markdown? > Have you ever wondered why there has been literally not a single > contribution to our web site from an external contributor? > > Have you ever wondered why there have been only two substantial > contributions to our documentation in the past 10 years? I suspect the > reason is the same. There are lots of reasons why people don't contribute documentation. > Oleg > > > > >> > Maven generated reports are not going to be there anymore. If some >> > people feel strongly about it, they are welcome to help fixing them >> > and >> > provide missing content. >> > >> > Oleg >> > >> > >> > > If the site is no longer built using Maven, then it may be >> > > difficult >> > > to preserve all the links (e.g. project info page links). >> > > >> > > It appears to be possible to use Markdown with Maven: >> > > https://stackoverflow.com/questions/14829190/how-to-use-markdown- >> > > for- >> > > maven-project-site >> > > >> > > Ideally anchors (internal page links) will also be maintained as >> > > far >> > > as possible. >> > > >> > > S. >> > > >> > > On 31 January 2018 at 19:15, Gary Gregory <[email protected] >> > > > >> > > wrote: >> > > > On Wed, Jan 31, 2018 at 7:57 AM, Oleg Kalnichevski <olegk@apach >> > > > e.or >> > > > g> wrote: >> > > > >> > > > > On Wed, 2018-01-31 at 07:43 -0700, Gary Gregory wrote: >> > > > > > > >> > > > > >> > > > > ... >> > > > > >> > > > > >> > > > > > On Wed, Jan 31, 2018 at 6:06 AM, Oleg Kalnichevski <olegk@a >> > > > > > pach >> > > > > > e.org> >> > > > > > wrote: >> > > > > > >> > > > > > Granted the site is not the most attractive, the only time >> > > > > > I >> > > > > > want to >> > > > > > dedicate to this topic is to discuss it here. I do not care >> > > > > > about >> > > > > > which >> > > > > > tools we use to get us to a new site. For my money, I'd >> > > > > > simply >> > > > > > try to >> > > > > > improved what we have now we a different stylesheet >> > > > > > (Fluido?). >> > > > > > For >> > > > > > example, >> > > > > > this is fine with me: >> > > > > > https://logging.apache.org/log4j/2.x/manual/architecture.ht >> > > > > > ml >> > > > > > and >> > > > > > it's all >> > > > > > Maven. >> > > > > > >> > > > > >> > > > > I understand that but you opinion might rapidly change once >> > > > > you >> > > > > actually need to author a substantial amount of content with >> > > > > xdoc >> > > > > or >> > > > > apt. >> > > > > >> > > > >> > > > Bah, it's just one format vs. another, it just depends on how >> > > > much >> > > > control >> > > > you want. >> > > > >> > > > For >> > > > https://www.manning.com/books/java-persistence-with-hibernate-s >> > > > econ >> > > > d-edition, >> > > > we wrote it all in XHTML. >> > > > >> > > > Gary >> > > > >> > > > >> > > > > >> > > > > Oleg >> > > > > >> > > > > ----------------------------------------------------------- >> > > > > ---- >> > > > > ------ >> > > > > To unsubscribe, e-mail: [email protected] >> > > > > For additional commands, e-mail: [email protected] >> > > > > >> > > > > >> > > >> > > --------------------------------------------------------------- >> > > ------ >> > > To unsubscribe, e-mail: [email protected] >> > > For additional commands, e-mail: [email protected] >> > > >> > >> > ----------------------------------------------------------------- >> > ---- >> > To unsubscribe, e-mail: [email protected] >> > For additional commands, e-mail: [email protected] >> > >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
