fluent / fluentd-docs

This repository is deprecated. Go to fluentd-docs-gitbook repository.
49 stars 119 forks source link

Clean up categories #86

Open repeatedly opened 10 years ago

repeatedly commented 10 years ago

I noticed some articles are placed under incorrect category.

We should move above artciles into correct category.

hkmurakami commented 10 years ago

+1

kiyoto commented 10 years ago

I think Community under Developer is okay (where else would you put it?)

I agree with Troubleshooting is miscategorized. So is Performance Tuning, Signals and Failure Scenarios, and possibly Monitoring.

I am thinking of moving them to a new category called Operations. Thoughts?

repeatedly commented 10 years ago

@kiyoto Community includes useful information for non-developer, e.g. SNS links and Meetup. So it seems common information.

@komamitsu suggested that use 'Operations' instead of 'Configuration' at first. After that, separating articles into another categories.

hkmurakami commented 10 years ago

I'm personally going to work on removing "mailing list", "source code" and "bug tracking" since they're now redundant with the community article.

Unless there's a good reason to keep redundancy (visibility?)

kiyoto commented 10 years ago

@repeatedly I don't think it's wise to call the top level category "Operations" since most people don't care to "operate" Fluentd instances at first. They probably want to configure it to play with it before they run a cluster of them.

@hkmurakami We definitely want to keep specific second level navs such as ML, source code, bug tracking. One idea:

  1. Create a category/section called Community
  2. Put stuff like mailing list, Twitter, Facebook there.
hkmurakami commented 10 years ago

@kiyoto Could we keep the second level navs but have them link to community#mailing-list, community#source-code, etc?

Presentation wise, having all the social/community stuff in one document seems like a better user experience than having many separate small docs.

kiyoto commented 10 years ago

@hkmurakami :+1:

kiyoto commented 10 years ago

Let's leave this issue open as we make iterative improvements on categorization.

hkmurakami commented 10 years ago

:+1: