juneau-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From James Bognar <james.bog...@salesforce.com>
Subject Re: Summary of websites.
Date Sun, 07 Aug 2016 17:01:08 GMT
Combo current state and vision

On Sunday, August 7, 2016, John D. Ament <johndament@apache.org> wrote:

> I'm a bit confused.  Is this meant to be current state or future state?
>
> On Sun, Aug 7, 2016 at 12:30 PM James Bognar <james.bognar@salesforce.com
> <javascript:;>>
> wrote:
>
> > Hi all,
> >
> > Here's a summary of our websites and their purposes.
> >
> >
> > *Main website - *http://juneau.incubator.apache.org/
> >
> > A very basic page with a quick summary and links.  Try to keep this
> sparse
> > (i.e. no knowledge articles, developer info, etc...).
> >
> >    - https://issues.apache.org/jira/browse/JUNEAU-6 - Complete project
> >    website.
> >    Current page was put together quickly and needs to be cleaned up.
> >
> >
> It should be the goal that juneau.i.a.o is the canonical home page and
> source of all things Juneau.  It may link to other resources, but as much
> as possible should go here IMHO.
>
>
> >
> > *Javadocs -*
> > http://juneau.incubator.apache.org/api-documentation/index.html
> >
> > We keep all of our user documentation in the Javadocs (overview.html and
> > package-level HTML files).  "Articles" can be written as HTML files in
> > doc-files directories.
> >
> >    - https://issues.apache.org/jira/browse/JUNEAU-10 - This is currently
> >    hosted by dumping the generated Javadocs into
> >    *incubator-juneau-website/content/api-documentation*.  It feels wrong
> >    storing generated Javadocs in a git repo.  Is there a better option
> for
> >    hosting javadocs?
> >
>
> I would recommend using maven-scm-publish to push to git after a build.
> Likewise come up with a release process.
>
>
> >
> >
> > *Incubator website -* http://incubator.apache.org/projects/juneau.html
> >
> > Really nothing of substance should be on this page except
> > incubation-related info.
> >
> >    - https://issues.apache.org/jira/browse/JUNEAU-8 - The data in the
> >    Project Info section should all be moved to the main website, and
> > Incubator
> >    information needs to be updated.
> >
> >
> > *GitHub mirror - *http://github.com/apache/incubator-juneau
> >
> > This mirror page is populated with data from the README.md in the source
> > code root.  Maybe just replace the contents with a link to the main
> > website?
> >
> >    - https://issues.apache.org/jira/browse/JUNEAU-5 - Update root
> > README.md
> >    file.
> >
> >
> > *Confluence workspace -*
> > https://cwiki.apache.org/confluence/display/JUNEAU/Juneau+Home
> >
> > All developer-related information should be kept here:
> > - Instructions on workspace setup
> > - Instructions on becoming contributors
> > - Design documents
> >
> >    - https://issues.apache.org/jira/browse/JUNEAU-7 - Set up Confluence
> >    workspace.
> >
> >
> Mmm this I'm iffy on.  We can have this hosted in confluence, or on the
> website.  Make sure the linking is bi-directional.  Its good to host
> designs in confluence.  The community aspects though I would hope are on
> the main website.
>
>
> >
> >
> >
> > --
> > James Bognar
> >
>


-- 
James Bognar

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message