Adds a "Guides" section to document

[amsaha]

Fixes issue #97

[amsaha]

/hold

[jlewi]

This is great; thank you.

/lgtm
/approve

Any reason for the hold? Just remove it if you think its good to go.

[amsaha]

/hold cancel
@jlewi not sure why there is a conflict in "content/docs/started/pytorch.md".

[amsaha]

@jlewi rebasing it fixed it :-) So just neet /lgtm label.

[amsaha]

@jlewi need lgtm on this one.

[sarahmaddox]

This is great, thanks for doing this! I have just one suggestion: Change the file name to use a hyphen instead of an underscore:
usage-reporting.md

Using a hyphen rather than an underscore in URLs is common practice. I see we use hyphens for all the file names in the getting-started section, and it'd be good to standardise.
https://github.com/kubeflow/website/tree/master/content/docs/started

Now that you're removing the old "user_guide.md", this is a good time to start the standardisation. :)

[amsaha]

Fair point.

[jlewi]

This looks great.

One more comment can we sort the Guides Alphabetically in the Guides Navigation section? I think that will be make them easier to find. I don't know if there's a way to do that automatically or if we have to manually adjust the order.

[amsaha]

@jlewi @sarahmaddox Making it alphabetical puts the "advanced" stuff first. Currently, I have put the "Requirements" first followed by "Ksonnet" which seems a reasonable order.

I don't think there is an easy way to order alphabetically. We will have to set the weights (hugo property) of the files properly.

[amsaha]

@jlewi can you take a look at this? This has been pending for sometime now.

[jlewi]

Sorry; was busy with next
/lgtm
/approve

/hold
This is a significant improvement so if you want to go ahead and submit it just remove the hold.

Your point about alphabetical not making sense is well taken.

The problem with the current layout is that I think a common mode is people will want to quickly find information about a particular component "e.g. seldon". In that case lack of Alphabetical ordering makes it really hard to find the information you want.

What if we had a subsection components and within that we alphabetized things

e.g.

Guides
Requirements
Components
jupyter notebooks
ksonnet
pytorch
seldon
tensorflow serving
tensorflow training
Troubleshooting
Upgrading Kubeflow
Usage Reporting

So within the components section we alphabetize but we order the other sections according to user flow

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jlewi

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [jlewi]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[amsaha]

@jlewi I agree. Will send another patch later in the day :-)

[amsaha]

/hold cancel

@jlewi I played around with a second level inside "Guides" and it is not trivial to do. I need to play around for sometime to do it. I suggest we handle it via a separate issue (issue #105)

[amsaha]

/hold cancel