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

Add SDK_By_Examples to doc #1795

Merged
merged 10 commits into from
Aug 12, 2018
Merged

Add SDK_By_Examples to doc #1795

merged 10 commits into from
Aug 12, 2018

Conversation

gamarin2
Copy link
Contributor

Add sdk by examples to doc, so that we finally have something to point to.

The current example is self-sufficient. It contains a lot of content that will later be moved to other parts of the docs.

@codecov
Copy link

codecov bot commented Jul 23, 2018

Codecov Report

Merging #1795 into develop will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1795   +/-   ##
========================================
  Coverage    63.46%   63.46%           
========================================
  Files          117      117           
  Lines         6927     6927           
========================================
  Hits          4396     4396           
  Misses        2276     2276           
  Partials       255      255

@@ -0,0 +1,7 @@
**SDK by Examples** offers an alternative and complementary way to learn about the Cosmos-SDK. It contains several examples that showcase how to build a decentralised application on top of the Cosmos-SDK from start to finish.

Without further due, let us get into it!
Copy link
Contributor

Choose a reason for hiding this comment

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

Without further ado


Without further due, let us get into it!

- [Simple governance example](./simple-governance/intro.md)
Copy link
Contributor

Choose a reason for hiding this comment

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

only one example for to start?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yup, when we have other examples we'll add them to the list

@@ -0,0 +1,25 @@
## Tendermint and Cosmos
Copy link
Contributor

Choose a reason for hiding this comment

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

we have this section in the docs already - can we add this content there instead of duplicating ideas?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

@@ -0,0 +1,3 @@
## Testnet
Copy link
Contributor

Choose a reason for hiding this comment

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

just delete this if it's not ready

Copy link
Contributor Author

Choose a reason for hiding this comment

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

But we'll get the question, so I feel it's good to have it apparent that it's WIP

Copy link
Contributor

Choose a reason for hiding this comment

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

what do you mean?

Copy link
Contributor Author

@gamarin2 gamarin2 Aug 10, 2018

Choose a reason for hiding this comment

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

We will get questions around testet, how to create one, etc. If this is clear that this is WIP, we won't have to say it is WIP to everyone all the time :p

Copy link
Contributor

Choose a reason for hiding this comment

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

but why is this the place to talk about testnets? it's in the SDK by examples section under simple governance?

and there is no content yet...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Bec. when you code a SDK app you want to launch a testnet for it at the end. And the point is precisely to show that there is no content yet, so that we don't get the question "where is the content?" x1000

Copy link
Contributor

@jbibla jbibla Aug 10, 2018

Choose a reason for hiding this comment

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

ok now i have a better understand of where you're coming from. thank you. it would seem to me that at the end of "building a dApp" you might want to do any number of things with it. one of which is launching your own testnet. maybe you want to connect to the hub or connect to an existing testnet. we should have content for all of these options - but since we don't - i'd prefer not to include a "TODO" in a production site.

when will the TODO be done?

can we either wait until then or remove it for now?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ok, I'll remove it for now

Copy link
Contributor

Choose a reason for hiding this comment

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

thank you.

@rigelrozanski rigelrozanski added T:Docs Changes and features related to documentation. ready-for-review labels Jul 31, 2018
@@ -1,7 +0,0 @@
# What is Cosmos?
Copy link
Contributor

@jbibla jbibla Aug 10, 2018

Choose a reason for hiding this comment

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

what is your thinking with regard to deleting this page?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

wanted to replace it with smth else but ended up not doing it. I'm adding it back. Will improve it later.

model](https://en.wikipedia.org/wiki/Object-capability_model)
and the [principle of least
privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege).
The [Cosmos-SDK](https://github.com/cosmos/cosmos-sdk) is a platform for building multi-asset Proof-of-Stake (PoS) blockchains, like the Cosmos Hub, as well as Proof-Of-Authority (PoA) blockchains.
Copy link
Contributor

@jbibla jbibla Aug 10, 2018

Choose a reason for hiding this comment

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

is it a platform or a framework?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

framework, modifying

@@ -0,0 +1,7 @@
**SDK by Examples** offers an alternative and complementary way to learn about the Cosmos-SDK. It contains several examples that showcase how to build a decentralised application on top of the Cosmos-SDK from start to finish.
Copy link
Contributor

Choose a reason for hiding this comment

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

👍👍👍

Copy link
Contributor

@jbibla jbibla left a comment

Choose a reason for hiding this comment

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

well done @gamarin2 !!

@ebuchman ebuchman merged commit c5fcc9b into develop Aug 12, 2018
@ebuchman ebuchman deleted the gamarin/sdk_by_examples branch August 12, 2018 07:37
@@ -0,0 +1,19 @@
## Submit a proposal

Uuse the CLI to create a new proposal:
Copy link
Contributor

Choose a reason for hiding this comment

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

Use

chillyvee pushed a commit to chillyvee/cosmos-sdk that referenced this pull request Mar 1, 2024
* feat: add globalfee initModule for upgrade handler

* chore: add comment for globalfee initModule

* fix: lint
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
T:Docs Changes and features related to documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants