Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

"Getting Started with DebOps" to pole position #246

Open
AnBuKu opened this issue Nov 19, 2016 · 3 comments
Open

"Getting Started with DebOps" to pole position #246

AnBuKu opened this issue Nov 19, 2016 · 3 comments

Comments

@AnBuKu
Copy link
Contributor

AnBuKu commented Nov 19, 2016

Currently Getting Started with DebOps is in the section Guides of the chapter DebOps playbooks. Path: Docs » DebOps playbooks » Guides » Getting Started with DebOps. - Short: Somewhere in the documentation.

Imagine, you are in the shoes of a DebOps Newbie and want to have a quick overview. Is DebOps for me? How do I get started? Can I quickly (20-30 minutes) do an initial set-up as a starter?
Therefore I propose to rethink current place of Getting Started with DebOps . As a future place in the pole position (index on left side) in documentation, above DebOps scripts would make sense.

@ypid
Copy link
Member

ypid commented Nov 19, 2016

Without having read all the intro again, I think that would make sense to have a more generic entry for new people and not start with the DebOps tools (one peace of the puzzle) first.

@drybjed
Copy link
Member

drybjed commented Nov 22, 2016

Sounds good. This probably means that with current documentation system the guides should be moved to the debops/docs repository to be properly placed.

@ypid
Copy link
Member

ypid commented Nov 22, 2016

@drybjed Could be done. Another way would be a separate repo like debops-intro or so. This would have the advantage of separate docs tests for PR which results in faster tests and easier to spot error messages.

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

No branches or pull requests

3 participants