Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-spec.committee] Guides
Agreeing on the structure for these api releases is something we need to do. The structure you outline is what I think is expected.

It seems like there should be a specifications/wombat/index.md or such page to be able to view all spec version releases. I also have not looked into Hugo and how that might be leveraged.


On Jul 11, 2019, at 3:14 PM, Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:

Great progress, thanks Scott!

I'm going to push some updates to the spec_page_template; you can yell at me if you really wanted to see a PR.  :-)

What should the directory structure under the specifications directory be?  I think we're expecting something like:

specifications
  wombat
    1.0
      wombat.md (from spec page template)
      wombat.pdf
      wombat.html
      javadocs (or "api"?)
    1.1
      ...
  platform
    8.0 (or "8"?)

We need to add this information to the README or pull request template.

Are there more "index" pages needed to link all the way down to wombat/1.0/wombat.md?  Or does hugo take care of that?  (I haven't learned anything about hugo yet.)


Scott Stark wrote on 7/10/19 9:49 PM:
The guides have been copied to the spec public folder and links emailed to the spec leads list.

TCK Process Guide:

I created a PR template:

And a spec page template based on the example servlet spec page Wayne had mocked up:

Finalizing exactly what needs to be in spec review PRs as well as the spec page template should be the focus of this Friday’s call.


_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee


Back to the top