Stephen, will the document-driven portion (i.e. master branch asciidocs, e.g. recipes) of the website always depend on the release process?
On Thu, Aug 4, 2016 at 12:32 PM, Dylan Millikin <[email protected]> wrote: > Yeah I think we can be incremental about this. > > - add the site to /site as is. This way even if it's a pain people can > contribute > - make a publish-site.sh > - add some form of template system (probably to publish-site.sh) > - finalize with documentation? < or add it as we go > > On Thu, Aug 4, 2016 at 10:12 AM, Stephen Mallette <[email protected]> > wrote: > > > There's not a lot of pages - true - though when i wear the release > manager > > hat i have grumble every time i have to go through all the links trying > to > > get it right. invariably i make a change, then copy/paste to the others > > only to find i misspelled something or missed a link. it just sucks. > That > > said, i'm open to the idea of moving the site as-is to the git repo > under a > > /site directory. that would be the first step to doing the static site > > generation anyway. > > > > if it doesn't hinge on static site generation, then perhaps it should > hinge > > on a little script or something that will bin/publish-site.sh - that > would > > be nice. > > > > On Thu, Aug 4, 2016 at 9:14 AM, Robert Dale <[email protected]> wrote: > > > > > Stephen, please correct me where I'm wrong, but after mirroring the > > > site and removing docs and javadocs since these are generated, it > > > would appear that there are only 7 html files to the website. It's not > > > clear to me that at this point the effort of creating or moving to a > > > template engine is worth the effort. I would rather see the static > > > site as-is move to version control sooner rather than later and not > > > hinge upon generation. > > > > > > On Wed, Aug 3, 2016 at 1:38 PM, Dylan Millikin < > [email protected] > > > > > > wrote: > > > > The groovy template engine could work just fine. > > > > FYI : > > > > > > > http://stackoverflow.com/questions/3793880/lightweight- > > template-engine-in-java > > > > There might be a few interested template engines there as well. > > > > > > > > On Wed, Aug 3, 2016 at 9:40 AM, Stephen Mallette < > [email protected] > > > > > > > wrote: > > > > > > > >> Yeah - i'm not so good with the sed to the awk to the grep or > whatever > > > so > > > >> if it can be that simple that would be awesome. The groovy template > > > engine > > > >> might be another option. Something like that would work easy enough > > too > > > I > > > >> would guess. I really don't think we need much more than that right > > now. > > > >> > > > >> Organizationally, I think we should have a /site directory at the > root > > > of > > > >> the repo to house the images/html template content and then have it > > > >> generate into root /target/site from bin/generate-site.sh. > > > >> > > > >> On Wed, Aug 3, 2016 at 9:29 AM, Dylan Millikin < > > > [email protected]> > > > >> wrote: > > > >> > > > >> > Hmm sounds like what we would want would be a template engine that > > > would > > > >> > help us build the static site. > > > >> > If all we need are includes that put together html partials > > > >> > (headers/footers) we could make our own. It could be as simple as > > > using > > > >> sed > > > >> > in bin/generate-web-site.sh > > > >> > > > > >> > On Wed, Aug 3, 2016 at 9:03 AM, Stephen Mallette < > > > [email protected]> > > > >> > wrote: > > > >> > > > > >> > > yes - static html/css and it sucks a bit because we don't have > any > > > >> re-use > > > >> > > going on there. so if we have to change a menu or something it > > means > > > >> > > changing it on every page in the site. would be nice to have > some > > > >> > re-usable > > > >> > > headers/footers and such. i looked into some static site > > generators > > > a > > > >> > while > > > >> > > back, but they all seemed like they did too much. maybe i didn't > > > know > > > >> > what > > > >> > > to look for. > > > >> > > > > > >> > > On Wed, Aug 3, 2016 at 9:00 AM, Dylan Millikin < > > > >> [email protected] > > > >> > > > > > >> > > wrote: > > > >> > > > > > >> > > > How is the current site structured? Is it just HTML and CSS > > files? > > > >> > > > > > > >> > > > On Tue, Aug 2, 2016 at 6:20 PM, Stephen Mallette < > > > >> [email protected] > > > >> > > > > > >> > > > wrote: > > > >> > > > > > > >> > > > > no - we don't have one for the main web site. i've wanted to > > > >> suggest > > > >> > > that > > > >> > > > > we change that though and generate the main web site from > the > > > >> github > > > >> > > > repo. > > > >> > > > > in that way we could easily accept pull requests and such. i > > > don't > > > >> > > think > > > >> > > > we > > > >> > > > > want to take a full asciidoc approach and the web site > > > generation > > > >> > would > > > >> > > > > probably stay separate from the doc generation, but it would > > be > > > >> nice > > > >> > if > > > >> > > > we > > > >> > > > > could bin/generate-web-site.sh for a local build of that > that > > > thing > > > >> > > which > > > >> > > > > could then be published to the apache svn repo. anyone else > > like > > > >> that > > > >> > > > idea? > > > >> > > > > if so, how would it best be done? > > > >> > > > > > > > >> > > > > > > > >> > > > > > > > >> > > > > On Tue, Aug 2, 2016 at 5:05 PM, Robert Dale < > > [email protected]> > > > >> > wrote: > > > >> > > > > > > > >> > > > > > Is there a git repo for this and the main website? I > would > > > like > > > >> to > > > >> > > > > > make pull requests to fix some things. > > > >> > > > > > > > > >> > > > > > On Fri, Jul 29, 2016 at 1:49 PM, Stephen Mallette < > > > >> > > > [email protected]> > > > >> > > > > > wrote: > > > >> > > > > > > The download page is now "live" > > > >> > > > > > > > > > >> > > > > > > On Thu, Jul 28, 2016 at 7:14 PM, Stephen Mallette < > > > >> > > > > [email protected]> > > > >> > > > > > > wrote: > > > >> > > > > > > > > > >> > > > > > >> I assume everyone is cool with making the Download Page > > > live > > > >> at > > > >> > > this > > > >> > > > > > point > > > >> > > > > > >> as there's been no other feedback in the last few days. > > > I'll > > > >> > > > probably > > > >> > > > > > make > > > >> > > > > > >> some adjustments to the web site tomorrow to bring it > > > online > > > >> > > > publicly. > > > >> > > > > > >> > > > >> > > > > > >> On Mon, Jul 25, 2016 at 7:33 AM, Stephen Mallette < > > > >> > > > > [email protected] > > > >> > > > > > > > > > >> > > > > > >> wrote: > > > >> > > > > > >> > > > >> > > > > > >>> I updated the downloads page some more: > > > >> > > > > > >>> > > > >> > > > > > >>> + tweaked the date format a bit to "really" match the > > > rest of > > > >> > the > > > >> > > > > site > > > >> > > > > > >>> (which is still inconsistent in other places like > > > changelog - > > > >> > > dah) > > > >> > > > > > >>> + added a "verifying downloads" section which talks > > about > > > >> > > > > GPG/PGP/etc. > > > >> > > > > > >>> > > > >> > > > > > >>> http://tinkerpop.apache.org/downloads.html > > > >> > > > > > >>> > > > >> > > > > > >>> > > > >> > > > > > >>> > > > >> > > > > > >>> > > > >> > > > > > >>> On Fri, Jul 22, 2016 at 3:53 PM, Stephen Mallette < > > > >> > > > > > [email protected]> > > > >> > > > > > >>> wrote: > > > >> > > > > > >>> > > > >> > > > > > >>>> Good feedback Robert/Jason. > > > >> > > > > > >>>> > > > >> > > > > > >>>> Updated: > > > >> > > > > > >>>> > > > >> > > > > > >>>> http://tinkerpop.apache.org/downloads.html > > > >> > > > > > >>>> > > > >> > > > > > >>>> Added documentation and included some descriptors to > > > current > > > >> > > > > releases. > > > >> > > > > > >>>> Didn't change the date format for now - that's the > > > format we > > > >> > use > > > >> > > > > > everywhere > > > >> > > > > > >>>> around "release" so didn't want to muck with that at > > this > > > >> > point. > > > >> > > > > > >>>> > > > >> > > > > > >>>> > > > >> > > > > > >>>> > > > >> > > > > > >>>> On Fri, Jul 22, 2016 at 3:36 PM, Robert Dale < > > > >> > [email protected] > > > >> > > > > > > >> > > > > > wrote: > > > >> > > > > > >>>> > > > >> > > > > > >>>>> Stephen, I think what Sebb might be getting at is > that > > > some > > > >> > > > things > > > >> > > > > > >>>>> should be spelled out even if they are obvious to > > some. > > > I > > > >> > agree > > > >> > > > > with > > > >> > > > > > >>>>> this. > > > >> > > > > > >>>>> > > > >> > > > > > >>>>> 3.2.1 (latest, stable) > > > >> > > > > > >>>>> 3.1.3 (bug fixes only) > > > >> > > > > > >>>>> > > > >> > > > > > >>>>> I think the dates should be in ISO8601 format. > > > YYYY-MM-DD > > > >> > > > > > >>>>> > > > >> > > > > > >>>>> Otherwise, I think it looks very good. > > > >> > > > > > >>>>> > > > >> > > > > > >>>>> -- > > > >> > > > > > >>>>> Robert Dale > > > >> > > > > > >>>>> > > > >> > > > > > >>>>> On Fri, Jul 22, 2016 at 2:51 PM, Jason Plurad < > > > >> > > [email protected] > > > >> > > > > > > > >> > > > > > >>>>> wrote: > > > >> > > > > > >>>>> > +1 looks great. > > > >> > > > > > >>>>> > > > > >> > > > > > >>>>> > Link to the documentation, maybe next to the > release > > > >> notes > > > >> > > > link, > > > >> > > > > > >>>>> would be > > > >> > > > > > >>>>> > useful too. > > > >> > > > > > >>>>> > > > > >> > > > > > >>>>> > -- Jason > > > >> > > > > > >>>>> > > > > >> > > > > > >>>>> > On Fri, Jul 22, 2016 at 2:07 PM, Stephen Mallette > < > > > >> > > > > > >>>>> [email protected]> > > > >> > > > > > >>>>> > wrote: > > > >> > > > > > >>>>> > > > > >> > > > > > >>>>> >> I think it might be a good idea to include a > > > "Download > > > >> > Page" > > > >> > > > on > > > >> > > > > > our > > > >> > > > > > >>>>> web > > > >> > > > > > >>>>> >> site. It would let us better list the versions we > > > have > > > >> out > > > >> > > > there > > > >> > > > > > and > > > >> > > > > > >>>>> would > > > >> > > > > > >>>>> >> get us better in line with Apache Infrastructure > - > > > for > > > >> > > > example: > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> https://issues.apache.org/ > > jira/browse/TINKERPOP-1255 > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> I'm also seeing that we yet have spots where we > > dont' > > > >> link > > > >> > > to > > > >> > > > > the > > > >> > > > > > >>>>> mirror > > > >> > > > > > >>>>> >> system. And finally, it would be nice to have a > > > >> "generic" > > > >> > > > > download > > > >> > > > > > >>>>> page > > > >> > > > > > >>>>> >> where we could point external links to - like the > > new > > > >> > > > > > "documentation" > > > >> > > > > > >>>>> >> feature in StackOverflow (right now it's sorta > > > hardcoded > > > >> > to > > > >> > > > the > > > >> > > > > > >>>>> mirror > > > >> > > > > > >>>>> >> which isn't so good because we'll have to change > > that > > > >> all > > > >> > > the > > > >> > > > > > time). > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> I quickly took a swipe at such a page: > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> http://tinkerpop.apache.org/downloads.html > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> It is NOT "linked to" by anything at this point > so > > > it is > > > >> > > > > > "hidden". I > > > >> > > > > > >>>>> just > > > >> > > > > > >>>>> >> wanted to have something that everyone could look > > at > > > to > > > >> > get > > > >> > > > the > > > >> > > > > > idea > > > >> > > > > > >>>>> of > > > >> > > > > > >>>>> >> what such a page might look like. > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> Thoughts? > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> Thanks, > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> >> Stephen > > > >> > > > > > >>>>> >> > > > >> > > > > > >>>>> > > > >> > > > > > >>>> > > > >> > > > > > >>>> > > > >> > > > > > >>> > > > >> > > > > > >> > > > >> > > > > > > > > >> > > > > > > > > >> > > > > > > > > >> > > > > > -- > > > >> > > > > > Robert Dale > > > >> > > > > > > > > >> > > > > > > > >> > > > > > > >> > > > > > >> > > > > >> > > > > > > > > > > > > -- > > > Robert Dale > > > > > > -- Robert Dale
