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

Polykey-Docs: Getting-Started-Documentation #72

Closed
wants to merge 15 commits into from

Conversation

CryptoTotalWar
Copy link
Contributor

@CryptoTotalWar CryptoTotalWar commented May 26, 2024

Description

This PR will be for fleshing out the tutorials / Polykey-CLI

Issues Fixed

Tasks

  • 1. review README for adding new pages to reference
  • 2. switch the order of the pages

Final checklist

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

@CMCDragonkai
Copy link
Member

See #71 (comment).

And also ensure that you be rebase squashed and follow conventional commit standard: https://www.conventionalcommits.org/en/v1.0.0/

@CMCDragonkai
Copy link
Member

Current state of staging is now in production. Ignore the current staging failure is that occurs because the branch is already up to date.

@CryptoTotalWar CryptoTotalWar force-pushed the getting-started-finalized branch from d734868 to 64baf0c Compare May 29, 2024 01:01
@CryptoTotalWar
Copy link
Contributor Author

Just rebased this feature branch off of the staging branch which had changes.

@CryptoTotalWar
Copy link
Contributor Author

For the managing env variables I am inclined to create a simple demo project that would typically have a .env file and move these env variables to a vault instead that will be injected.

Following the following guidelines: https://www.phind.com/search?cache=vjacfmn8ykb7e652jukukkxm

Refine the tutorial on claiming digital identities in Polykey. Include detailed steps for authentication with GitHub, claiming an identity, and verifying the claim. Add a note on the possibility of claiming multiple identities for different nodes.
- Revise the entire tutorial for claiming digital identities to enhance clarity and user guidance.
- Add images to demonstrate key steps in the GitHub authentication process and illustrate the concept of gestalt graphs.
- Include detailed explanations of permissions used during the GitHub authentication.
- Improve the verification steps to ensure users can confidently verify their identity claims.
- Expand the discussion on gestalt graphs, including their operational dynamics and the benefits of federated identities.
Update the section on claiming multiple identities to clarify that multiple nodes can claim the same GitHub identity and that a single node can link to multiple identity providers. Revise the document title to 'Claiming Digital Identities: Establishing Identity Linkages in Polykey' to better reflect the content and impact.
Update the documentation to enhance clarity and accuracy in the identity authentication and claim sections. Include detailed command usage, provide examples for verifying authenticated identities, and adjust the descriptions to better explain the management of multiple identities across nodes and IdPs. Improve navigational instructions for gist verification and incorporate feedback on security and privacy considerations.
Add detailed explanations of gestaltId and permissions within the 'Discovering Users' Nodes and Managing Access Permissions' section. Include examples and syntax clarifications to improve understanding and implementation of node interactions and access controls.
@CMCDragonkai
Copy link
Member

CMCDragonkai commented Jun 5, 2024

This PR is not triggering the CI because it doesn't have the right branch name it should be feature-X.

Expand the Sharing Vaults With Secrets documentation to include detailed steps for sharing, scanning, cloning, and synchronizing vaults. Add troubleshooting guidelines and link back to prerequisites from the Discovering Users' Nodes and Managing Access Permissions section for a streamlined user experience. Include code examples for each critical operation and emphasize debugging techniques for common sharing issues.
…d node designation

Update the 'Managing Multiple Nodes' tutorial to enhance readability and practical application. Rename 'nodeA' to 'nodeB' to align with Shell B designation, streamline environment configuration steps, and clarify the process of sharing vaults between nodes. These changes aim to simplify the tutorial's execution and improve its educational value for new Polykey users.
@CMCDragonkai
Copy link
Member

  1. Tasks need to be specified - and need to be specific.
  2. They need to be ticked off as you're working on them
  3. They represent what still needs to be done - can you delegate this to another person and they would understand what still needs to be done?
  4. This represents implementation not requirements - so they much more specific
  5. Don't leave hanging tasks.
  6. Review the checklist
  7. Make sure you're commenting when a PR closes another PR

Revise the tutorial page for  to include comprehensive usage examples and explanations of dynamic environment variable management. Enhance sections covering secure environment variable injection, output formats, handling name conflicts, and integrating with cloud services. Add detailed examples for each use case to guide users on effectively applying the command across different contexts.
Enhance the README documentation for the Polykey CLI tutorials page by restructuring the overview, clarifying the supported platforms, and providing a more organized guide through the tutorial sections. Include links to further resources for user engagement and outline advanced scenarios to prepare users for comprehensive usage of Polykey's features.
@CryptoTotalWar
Copy link
Contributor Author

Closing PR as it had the incorrect branch name, created a new PR for this here #75

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

Successfully merging this pull request may close these issues.

Polykey-Docs: Flesh out Polykey-CLI Tutorials "Getting Started"
2 participants