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

Create a Quickstart guide Template and Quickstart Section for the Safe Core SDK #163

Closed
wants to merge 19 commits into from

Conversation

ademidun
Copy link
Contributor

@ademidun ademidun commented Feb 16, 2023

This PR has been moved to #165

This PR was created before I had write access to this repo.

This PR introduces a standard template that all quickstart docs should follow as part of the Developer Docs Status Update: 2023-02-22.

The goal of each quickstart is to provide the "minimum viable code" that a developer needs to complete a task using a given package or library. Any additional functionality can go into a separate "Detailed Guide" doc as seen in this example: Guide: Integrating the Safe Core SDK.

This quickstart shows the "minimum viable code" needed to create a Safe and propose and execute a multi-sig transaction using the Safe Core SDK.

Each quick start guide should include the following:

  • About the tool:
    • This tool allows you to... Some examples of things you can do with this tool include...
  • Quicsktart
    • This quickstart will show you how to...
  • Prerequisites:
    • what to install, existing accounts, ETH/tokens required to complete this, any API keys required, etc.
  • Copy-paste code snippets to complete the task
  • Make example compatible for running in Goerli testnet

Style Guide

  • Put code snippets inside triple backticks instead of single backticks to enable the copy-paste button
  • Include the language in your code snippets so that syntax highlighting is enabled

Screen Shot 2023-02-22 at 6 37 37 AM

Screen Shot 2023-02-22 at 6 37 10 AM

Project Management

@ademidun ademidun changed the title Create Safe Core SDK guide Create a Quickstart guide for the Safe Core SDK Feb 16, 2023
@ademidun ademidun changed the title Create a Quickstart guide for the Safe Core SDK Create a Quickstart guide Template and Quickstart Section for the Safe Core SDK Feb 22, 2023
@ademidun ademidun marked this pull request as ready for review February 23, 2023 08:09
Copy link
Member

@germartinez germartinez left a comment

Choose a reason for hiding this comment

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

Please, review some comments regarding a few little inconsistencies

  • Remove all semicolons (some lines contain semicolons, others don't)
  • Start all comments in the code with uppercase (some comments start with uppercase and some lowercase)
  • Some titles have all their words starting with uppercase, some have just the first word.
  • Only use single quotes (some strings have double and others have single quotes)
  • Review code indentations and only use two spaces

We should not base our tutorials/guides on content created outside of our team, as they will probably not be up to date and will be more difficult to spot possible errors (using deprecated interfaces, parameters, etc.). It would be good, as a final test, if you could try the code and make sure it works properly.

@germartinez
Copy link
Member

It's probably useful to point to the Safe Core SDK API Reference as well when linking to the detailed guide

ademidun and others added 2 commits February 24, 2023 05:49
Co-authored-by: Germán Martínez <6764315+germartinez@users.noreply.github.com>
Co-authored-by: Germán Martínez <6764315+germartinez@users.noreply.github.com>
@ademidun
Copy link
Contributor Author

Closed by #165

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 this pull request may close these issues.

Quickstart for safe-core-sdk
3 participants