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

[ EPIC ] Developer Documentation #61

Open
5 of 24 tasks
jpaulet opened this issue Apr 19, 2023 · 4 comments · Fixed by #69
Open
5 of 24 tasks

[ EPIC ] Developer Documentation #61

jpaulet opened this issue Apr 19, 2023 · 4 comments · Fixed by #69

Comments

@jpaulet
Copy link
Member

jpaulet commented Apr 19, 2023

As a developer/integrator, I need good documentation and a clear getting started guide for using the SDK and all the tools that Vocdoni offers to me.

Write new docs

From getting started section:

  • Create the "Getting Started Guide" (now we are using the SDK readme, maybe can be this?)
  • Add UI-Components docs
  • FAQs

Tutorials (inside getting started):

  • Create your first election
  • How to configure the lifecycle of an election
  • Census types and how to create them
  • Retrieving elections results
  • Vote in an election
  • Create your first quadratic voting

Protocol (inside Reference):

  • Encryption and validators
  • Faucet package
  • Transactions
  • Results
  • Accounts and organizations
  • Libraries and tooling
  • Pricing

Vochain (inside Reference):

  • Run a node
  • Deployed networks
  • ...?

Old Docs:

  • Retrieve and propose what we can reuse from docs.vocdoni.io
  • Merge the 2 docs in 1
  • Redirect docs.vocdoni.io to developer.vocdoni.io

More tasks:

  • Plausible events for new sections
  • Add SDK changelog into the Developer Portal

More references: https://www.notion.so/aragonorg/Developer-Portal-a8c15bc54bcb4e759fc8eda248c7afe3

@selankon
Copy link
Collaborator

I added a tasks Plausible events for new sections to the backlog

@selankon
Copy link
Collaborator

The current docusaurus changelog plugin is a custom plugin located here:

https://github.com/facebook/docusaurus/tree/main/website/src/plugins/changelog

And is not placed for download. For the moment we could just copy the changelog among sdk README to the correct place on the CI.

@selankon
Copy link
Collaborator

Changelog marked as resolved

#68
vocdoni/vocdoni-sdk#162

@selankon selankon linked a pull request Apr 27, 2023 that will close this issue
@selankon
Copy link
Collaborator

Merge the 2 docs in 1 task will be completed after

#69

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

Successfully merging a pull request may close this issue.

2 participants