Anything you need help with? Robert Dale
On Tue, Aug 15, 2017 at 8:22 PM, Stephen Mallette <spmalle...@gmail.com> wrote: > yes - i didn't see any objections or other suggestions so I moved with what > I proposed. pretty minor differences but i think it's an improvement. i'd > like to work on the publications section a bit but we're still semi-jammed > with doc generation problems atm. > > On Tue, Aug 15, 2017 at 8:06 PM, Robert Dale <robd...@gmail.com> wrote: > > > I see changes. I guess the 72 hours is up! > > > > Robert Dale > > > > On Wed, Aug 9, 2017 at 11:15 AM, Stephen Mallette <spmalle...@gmail.com> > > wrote: > > > > > I've been thinking about documentation a bit. I don't think folks are > > aware > > > of all the documentation that we have. The typical example is the IO > > > Reference docs which no one every seems to find: > > > > > > http://tinkerpop.apache.org/docs/current/dev/io > > > > > > I long ago added this documentation landing page: > > > > > > http://tinkerpop.apache.org/docs/current > > > > > > which I also think no one really knows about, but it lists all of our > > > documentation and puts it all into categories. I've updated that a few > > > moments ago a little bit (but have not yet published) with a few more > > > changes to come: > > > > > > https://github.com/apache/tinkerpop/commit/ > > 0108bfcc0c1646e23a92a459f12dd8 > > > f48b80a233 > > > > > > I think we should make this "Compendium" page more the focus of where > > folks > > > go to get documentation. That would mean: > > > > > > 1. On the TinkerPop home page, remove "Tutorials" and "Publications" > > > sections - right now they are in sync with the Compendium. I sense > we're > > > missing a few useful publications there. It might also be nice to > offer a > > > better explanation of what each publication is and why a user would > want > > to > > > read them. "Graphendodonticology" is an awesome post, but the title > > really > > > doesn't give anyone a hint as to why they would want to click on it. We > > > can't really do that now on the home page without blowing it out super > > > long. > > > 2. Change the "Documentation" section on the home page to basically > look > > > like this: > > > > > > * TinkerPop Documentation > > > ** Reference Documentation > > > * Upgrade Documentation > > > * Javadoc - [core] / [full] > > > > > > So basically, the first bullet above will go to the compendium. The > rest > > of > > > the links should be self-explanatory. > > > 3. Change the Documentation/Publications to link to the > > > Compendium#Publications > > > > > > Any thoughts on the matter? > > > > > >