Skip to content
This repository was archived by the owner on Oct 28, 2024. It is now read-only.
This repository was archived by the owner on Oct 28, 2024. It is now read-only.

split into two profiles: users and administrators #50

@bacongobbler

Description

@bacongobbler

Eventually I'd like to split the docs into two groups: users and administrators.

Administrators are the individuals who maintain the infrastructure necessary to host applications. They are the ones installing, upgrading, and maintaining their own instance of hippo-server. They may also be responsible for administrative tasks like registering new accounts or writing new "helper tools" using the API as a reference guide. They want to know how to upgrade hippo-server, how to query the database, domain/TLS configuration, and how hippo-server communicates with nomad. They may also want to know how to handle Disaster Recovery (DR) scenarios.

Users are individuals who interact with the Hippo CLI. They are the ones creating applications, setting up release channels, inviting members to collaborate on an application, uploading apps to bindle, etc. They want to know what a HIPPOFACTS file does, how to register an account, create an application, and upload their source code. They may also want to know how to ensure other users cannot see their apps, or how to add other users to collaborate on their app. They may also want to know how to set up snapshots or advanced release channel configuration.

Right now the quickstart documentation tried to cover both bases by asking the user to install hippo, boot hippo-server, and create an app. I'd like to make that focused purely on the "User", and move the "boot hippo-server" guide to a separate section of the documentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions