Skip to content
This repository has been archived by the owner on May 17, 2019. It is now read-only.

Clean up categories #86

Open
repeatedly opened this issue Feb 17, 2014 · 9 comments
Open

Clean up categories #86

repeatedly opened this issue Feb 17, 2014 · 9 comments

Comments

@repeatedly
Copy link
Member

I noticed some articles are placed under incorrect category.

  • trouble-shooting, signals and etc articles are in Configuration.
  • Community is in Developer.
  • etc...

We should move above artciles into correct category.

@hkmurakami
Copy link
Member

+1

@kiyoto
Copy link
Contributor

kiyoto commented Feb 17, 2014

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
Copy link
Member Author

@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
Copy link
Member

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
Copy link
Contributor

kiyoto commented Feb 17, 2014

@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
Copy link
Member

@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
Copy link
Contributor

kiyoto commented Feb 18, 2014

@hkmurakami 👍

@kiyoto
Copy link
Contributor

kiyoto commented Feb 18, 2014

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

@hkmurakami
Copy link
Member

👍

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants