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

Docs need more instructions on what each step does #331

Open
tapishr opened this issue May 12, 2024 · 1 comment
Open

Docs need more instructions on what each step does #331

tapishr opened this issue May 12, 2024 · 1 comment
Assignees
Labels
documentation Improvements or additions to documentation feature Issue is part of a feature

Comments

@tapishr
Copy link
Member

tapishr commented May 12, 2024

Setup Guide Design

Introduction page

Our documentation will have an introduction page which will go in depth about the features, the architecture and the steps to set it up.

User Guide

Getting Started

For the quick setup guide, we will have a single page with clear instructions on the next step based on the previous step. We will not have separate pages for each step of the setup because it lacks sequence and would turn out to be confusing.

Installation for GitHub

We will have several pages for each part of this so that people can access the guides for each page even if they are not doing the installation themselves. These pages will be non-actionable. Only explanatory.

Installation for Bitbucket

Same as the GitHub section - only explanations so that a person can understand how things work in a different device than the one they are using for the actual installation.

Developer Guide

This section will be dedicated to getting a new contributor started with Vibinex.

Setting up the environment

  • What are the things they need to install
  • How do they acquire the various environment variables needed
  • Running the whole application end-to-end

Understanding the code

  • Definitions (provider, owner, repository, pull request, review, hunk, author, relevant reviewer)
  • Folder structure of each repository
  • Network architecture & PubSub

Contribution Guide

  • Communication (tags in issues, joining Slack, basic etiquette)
  • Branching, formatting, testing (sanity check, unit testing, end-to-end testing)
  • Perks (compensation through alokit.in, opportunity to work with the Vibinex team, entry into the OSS ecosystem),
@tapishr
Copy link
Member Author

tapishr commented May 13, 2024

Note should be lighter, in italics, change on configuration selection, bulleted or numbered, can include link to architecture/data diagram

@tapishr tapishr changed the title docs need more instructions on what each step does Docs need more instructions on what each step does May 13, 2024
@avikalpg avikalpg added documentation Improvements or additions to documentation feature Issue is part of a feature labels May 30, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation feature Issue is part of a feature
Projects
None yet
Development

When branches are created from issues, their pull requests are automatically linked.

2 participants