Skip to content

Conversation

@CryptoTotalWar
Copy link
Contributor

@CryptoTotalWar CryptoTotalWar commented Jul 18, 2024

Description

Issues Fixed

Tasks

  • 1. add sidebar for docs homepage

  • 2. edit docs homepage for engagement and effective overview of the docs

    • clean up to the point that its a sufficient overview for a V0
  • 3. flesh out / update a finalized version of the polykey-set-up page for installing and bootstrapping

  • 4. flesh out / update a finalized version for connecting to an IDP

  • Need a section first where we have them create a vault, create a dummy secret, add it to the vault, and then get it in the terminal. This will be the same vault they share with the other node.

  • 5. flesh out / finalize a PK demo that follows the demo tutorial but requires bootstrapping / managing a second node locally, alternatively, they can find another dev to perform the demo with... Ideal.

  • 6. clean up getting-started docs, the previous documentation should be synthesized in reference guide documentation

Final checklist

  • Domain specific tests
  • Full tests
  • Updated inline-comment documentation
  • Lint fixed
  • Squash and rebased
  • Sanity check the final build

@CryptoTotalWar CryptoTotalWar added the documentation Improvements or additions to documentation label Jul 18, 2024
@CryptoTotalWar CryptoTotalWar self-assigned this Jul 18, 2024
@CryptoTotalWar CryptoTotalWar added the enhancement New feature or request label Jul 18, 2024
Improve the getting started section for setting up Polykey:
- Updated instructions for installing PK-CLI.
- Added detailed steps for bootstrapping the first node.
- Included screenshots for better visual guidance.
- Added inline notes, warnings, and tips to enhance user understanding.
- Ensured consistent terminology and clear explanations throughout the guide.
@aryanjassal
Copy link
Contributor

I might take over this too

@CMCDragonkai
Copy link
Member

Create a new PR and synthesize changes from this PR into a new branch.

Consider if the changes here have interactions with #137. If not, then branch off the tip of staging. If yes, then branch off from the tip of #137.

@xrissoula

Then close this PR in favour of the new PR.

# Set-Up Polykey on your Machine

Installing the CLI can be done in different ways depending on your operating environment.
:::note
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

::: ##Heading

@CMCDragonkai
Copy link
Member

Closed in favor of #139.

@xrissoula xrissoula mentioned this pull request Apr 11, 2025
11 tasks
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 enhancement New feature or request

Development

Successfully merging this pull request may close these issues.

Polykey-Docs 1.0: Revamping the PK-CLI set-up Guide under Getting Started Category

6 participants