Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-spec.committee] Operations document conversion


On Wed, Jan 15, 2020 at 4:56 PM Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:
The jakarta.ee PR has already been merged so I guess it's too late to comment on it.

There doesn't seem to be any top level navigation to get to the "committees" page.  And if you do get there, it doesn't describe all the committees and link off to pages for each committee as I expected, it just describes the one document you've published.  That seems a bit short sighted.  And the right navigation isn't specific to the committee page you're on.  It seems like a bit more thought needs to go into the structure of these pages.

Correct, I didn't create any navigation to this page intentionally as I don't know how we want it. I only took on me to convert the document and get it out there. Anyone can send a PR to make changes or add information. If we want a description of each committee, then let's do that. The directory structure is set up to allow for that. 

The entire site needs an overhaul when it comes to navigation. 


Are you also going to convert the process.adoc (which really ought to be named TCKprocess, just like the png file)?

My thought was to do the operations doc. Then describe the steps so anyone can convert the rest. I can make a pass at it next time I have some time over if no one else has picked it up.


It's less clear what to do about names.adoc.  Do people think it should be converted and published on jakarta.ee?

Ditto steps_javaee_to_jakartaee.adoc?

These are kind of one-off for this release? 
 
 


Ivar Grimstad wrote on 1/15/20 8:39 AM:
Hi,

As requested at our meeting last week, I have converted the operations document from AsciiDoc to Hugo Markdown and created a pull request to get it published under https://jakarta.ee/committees/specification/operations. 


I have also created a PR to remove the original from the specification-committee repository to avoid duplication and confusion. This PR can be found here: https://github.com/jakartaee/specification-committee/pull/26

If we want more content added to the jakarta.ee website, it can be added by creating a PR the same way as for this document.

Ivar
--

Ivar Grimstad

Jakarta EE Developer Advocate | Eclipse Foundation, Inc.

Eclipse Foundation: The Platform for Open Innovation and Collaboration

_______________________________________________
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



--

Ivar Grimstad

Jakarta EE Developer Advocate | Eclipse Foundation, Inc.

Eclipse Foundation: The Platform for Open Innovation and Collaboration

Back to the top