10 KiB
| title | description | excerpt | header | tags | toc_sticky | date | author_profile | authors | published | last_modified_at | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DIDecentral: Contributors Intro | Getting started contributing to DIDecentral via Twitter, Discord Chat, and GitHub. | A variety of ways to contribute to DIDecentral with a minimal barriar to entry. Starting from Twitter, Discord Chat, and GitHub. |
|
|
true | 2019-07-06 | false |
|
false | 2019-07-14T11:22:33-23:00 |
We are happy for contributions from anyone, regardless of technical skills, or pre-existing knowledge. The intention for this Community Website is to focus on detailing a variety of ways to contribute, and to enable anyone to become more familiar with web-publishing, in a low stakes environment, while pursuing a passion for Sovereign Identity.
Comments!!!!
Yay! Because of the static nature of webpages hosted from GitHub, its required to make an integration of some sort. Some active agent online must recieve the comment, and leave a properly formatted pull-request.
It would be simple enough to use a third party comments system. However, I really wanted to use @Staticman which is an open source application that I could independently run on a pi, or even a free heroku instance. It's a portable solution, that enables complete operator control over its implementation.
It took quite a bit of effort, searching through github issues, and following all trails, but I finally figured out a good build and got it properly set up.
Soon, you will be able to leave a comment on any page in the DIDecentral ecosystem. Making it simple for anyone to note ideas, share links, suggestions, and typos as you browse.
GitHub is Designed for Collaboration
We welcome issues or pull requests for question, comments, or contributions of every type. While some may feel intimidated to get started with GitHub, we assure you it's just like any other social platform with user profiles, content, text fields and buttons.
If you have questions, other people probably want to know the answer also. Its not easy to remember and document every sticky point of working with github pages, discord, and associated digital tools.
However, over time, through the process of collaborative editing, crowdsourcing ideas, and learning together, to discover and extract value from various datasets.
{% include figure image_path="https://imgur.com/WJVcyXT.png" alt="github.com/didecentral" caption="github.com/didecentral" %}
DIDecentral - Repositories
A number of repositories which will be good sources for content creation have been forked into this organization for reference. The following are the primary repositories under our care.
- DIDecentral
- didecentral/community-website - Community Site and Archive
- didecentral/decentralized-id.com - Decentralized Identity
- didecentral/rwot-dir - Rebooting Web of Trust - Archive (once built, to be integrated with WebOfTrust.Info, somehow)
- Identitywoman/identity-commons - To become the source for Decentralized ID history, merging our combined resources.
Besides these, @infominer33 commonly forks repositories into the organization that seem like good sources for future collaboration and\or content creation.
GitHub Issues
- didecentral/community-website/issues
- didecentral/decentralized-id.com/issues
- didecentral/rwot-dir/issues
Generally speaking, this is a good place if you have a link or two to contribute, a question, ideas, want to point out a broken feature, or even just to say Hello :D
Github issues are just like the comments feature, except it lets you note where exactly in the source there is a problem, or you have a suggestion. We're open to feedback and collaboration in whichever venue you prefer.
Pull-Requests
- didecentral/community-website/pulls
- didecentral/decentralized-id.com/pulls
- didecentral/rwot-dir/pulls
These are good if you'd like to correct something, or suggest some changes to any aspect of the site. Also, a pull-request is the official pipeline for introducing changes to a repository.
Over time we will introduce more fine grained guides on how to do this in a way so that your contribution is easily accepted and recorded in the git history.
"Edit This Page"
Nearly every page has a section like this, where you can share socially, or edit\view on GitHub.
Clicking that button takes you to the unformatted version of the page on GitHub. When you are logged in to GitHub, that puts you one click away from editing this page: look for the pencil icon on the right side, just above where the line-numbered raw file begins.
Clicking it will reload an take you to an editable version of the page, which proposes an update through github. The monitor icon will open an editable change-proposal of the file. This allows you to contribute through a familiar interface (your web-browser), without having to understand anything about GitHub.
Whether it's an actual improvement, fully functioning with proper markup, or simply a note, it will be read and appreciated! Even if your change isn't perfect: We'll try to accept it and include your "commits", which are Git's way of recording contributions that GitHub has built a web-interface over.
None of us are necessarily professional or experts with git or web-publishing. However, we do wish to learn and grow our digital skillset.
If you all could just..
If you would export me a copy of your bookmarks.... that would be great! After a while I'll make a few fine grained how-to. This is one of the simplest ways that nearly anyone could make a significant contribution.
We would be happy to accept your raw unsorted bookmark exports! :D
I will create detailed guides, to ensure that everyone is able to click a few buttons and share the wealth!.
Twitter @ Mention and Hash Tags
You can simply @ mention @didecentral, and it's activity will be preserved, soon to by syndicated here on this website, via indieweb design. I will also follow related hash-tags and see about re-publishing them here, somehow.
I will track #decentralizedidentity, #selfsovereignidentity, and #didecentral. The final one is similar to @mention, a way for the community to track a larger volume and variety of content than would typically warrant a @mention.
Contributing Via Discord
Discord is, hands down, my favorite way to organize information on the fly. It's also quite useful for collaboration. -@infominer33
If you've never used it before, Discord is a powerful, free-to-use, closed-source communication/collaboration platform like Slack or Telegram, originally designed for the gaming community but since popular with opensource projects and startups.
{: .align-right}
There are a couple simple ways of sharing to discord that have made it quite convenient for keeping track of information.
Its also possible to leave comments, and questions inline with the links. Any that have substance, and are on-topic for the channel they are in, will be re-published in the periodic export of discord to this web-site.
One of the great things about Discord is that they have made it a very welcoming space for developers. There are a multitude of open source bots already made for discord, and plenty of people learn to develop by building them. (leaving a wide open door for future integrations)
Discord Desktop
Desktop is much nicer than Moble, for my purposes. Once opened to the Discord App, hit ctrl + k and begin typing the name of the channel where you'd like to go.
Even if you don't remember the channel name, it's usually simple enough, even dropping it in the #library-submissions or #general will suffice on the fly, and later, the link will be dropped in its appropirate channel.
Discord Mobile Share
I have an iPhone, and will have to discover how to do this with Android. However, I hope it's rather intuitive, once you think of it.
I had to enable sharing to discord, and you might have to do the same type of thing with android. Once you've set up the sharing integration, then it's simple to do, on the go.
1 
2 
3 
4 
Discord Web App
There is totally a web-app for discord if for some reason you are unable to install the app. We'll embed it into the website sometime :)
Telegram Chat
I've heard complaints that Discord uses a lot of mobile bandwidth, and that we should have a telegram channel.
If you want to open a DIDecentral telegram chat, please do and invite @infominer, invites open.
Thanks for Visiting!
As I hope is clear, we are committed to making this resource as accessible for collaboration as possible. To eventually include how-tos for everything from the simple to the big picture.
Feel free to visit Web-work.tools for an array of entry-level web-work how-tools.