yes that is what i mean.
also i was looking through the JBake docs and it is possible to define
tags on pages. this might be useful where a page is relevant to more
than one index?
On 03/12/2018 16:25, Bruno Baptista wrote:
Hi
Do you mean, the Apache license in header on the top of each source file?
Cheers
Bruno Baptista
https://twitter.com/brunobat_
On 03/12/18 11:25, Matthew Broadhead wrote:
Should the licence be stored centrally and appended to the top (or
bottom) of each page?
On 03/12/2018 04:21, David Blevins wrote:
Hello hopeful contributors!
As of this weekend we have two new index pages for our documentation
on the website:
- http://tomee.apache.org/tomee-8.0/docs/
- http://tomee.apache.org/tomee-8.0/examples/
The source for each of these index pages is generated by walking
over each Markdown or Asciidoc file in these two sections of the
main repo and looking for an `index-group=Foo` header in the
document. That's how they get grouped.
- https://github.com/apache/tomee/tree/master/docs
- https://github.com/apache/tomee/tree/master/examples
In the 'docs' directory alone there are 165 files that have
"Unrevised" as the header or no header at all. We need to get a
header on all 165 of them.
If you're looking for a way to contribute, there are 165 of them
right there. At 15 minutes each document that's 2475 minutes or
41.25 hours of community work.
^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^
^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^
^ ^ ^ ^ ^
:)
What we need is each doc to be reviewed, checked for any formatting
issues such as inconsistent h1, h2, h3 usage, then make your best
guess on what the topic is (JavaMail, JMS, CDI, JPA, etc), then set
that as the header `index-group=JMS` and submit a PR along with any
updates to the document you think are good (maybe none at all)
Here's a couple sample commits:
-
https://github.com/apache/tomee/commit/bdee81d34c60644b755621254a535d0d8757eb21
-
https://github.com/apache/tomee/commit/e2190a47c211c870680d761efd6d025d935546c7
If you'd like to build the docs locally, run this long command and
then open your browser to http://localhost:8080
- git clone g...@github.com:apache/tomee-site-generator.git && cd
tomee-site-generator && mvn clean compile -Djbake.http=true
On the formatting inconsistencies:
- We use to use Confluence. There are actually some pages still
with that old format.
- Some docs randomly start at h3 or h5. They need to start at h1
and strictly not jump to h3 without an h2 in the middle.
- If you have the energy to convert it from Markdown to Asciidoc,
yay!
We need to do this for both the docs and examples.
- https://github.com/apache/tomee/tree/master/docs
- https://github.com/apache/tomee/tree/master/examples
