Expand sources of knowledge while maintaining a high-quality of information
The long-term vision of open information (OI) is to expand the ability to collaborate. Open information include relevant outside resources, context, and etc. with X times the brain power in real-time with collaboration vs. single sources of truth.
I’ve created open info from official documentation and other community related sources. I’m looking forward to moving away from Google docs towards a platform with more of the attributes defined above.
Seems to be a more common standard across software and crypto teams.
Has some clunky UX elements and things that’d be nice if they could be customized.
After creating my first full HackMD page it has the best end user UX. The published page is fully reactive to any re-sizing with navigation elements transformed into useful buttons. This is the best balance of clean published UX, VCS integrations, and potential for future customization.
Lean product and engineering team.
Love the clean design of the published pages, Ethereum Foundation adoption, and great use case examples.
More customization with GUI editor due to direct Markdown access. Further Enterprise customization.
Incredible editing and published UX.
Does not seem to have VCS integrations.
Closely matches crypto ethos: Sign-in with Ethereum (SIWE), IPFS hosting, Ethereum Naming Service (ENS) support, and etc.
However, pages still are in an early version with not a lot of customization or integrations yet.
The very first thing I ever wanted to make was a general knowledge compendium but then realized that was impractical to start so went with a niche area to begin. I figured to go with quality knowledge hosted in a large bank. Anyone could reference the information stored, it would be verified by community members and actively curated/maintained.
I have experimented with Notion for my own project and came up with a kind of community center that doubles as a page to aggregate information about web3/crypto— at least, in relation to the project I’m building: DecentrAgora Community Center
I’ve really enjoyed the flow and having designed documentation with Gitbook and Docusaurus I’ve found that Notion adds a bit of flare that is generally fun to use.
Recently a few different things have made me think about this as well. There is a general need for an Eth hub that’s always accessible
I know Eth Hub was winded down with the intention that Ethereum dot org would maintain a knowledge bank but they need a lot of help with this too so it’s certainly worth it to explore
The Ethereum websites repo had over a hundred open issues when I last checked and not long before that it was 200+
Thank you for sharing your experience with Notion and kind words @raynemang! I’ll take a look at the DecentrAgora pages the community has built.
Have you used or do you know if Notion has two-way syncing with version control systems (VCS) like GitLab/GitHub repositories?
This is important to back up the entire contents of projects and provides a path to decentralize in the future because VCSs can be automated to deploy and host content to IPFS and Arweave in a future more decentralized version of this info.
That’s a good question, I know there are a number of integrations usable with Notion and Github is one so I suspect there would be a way to sync data across the two places
I’m unsure about the version control, but I do know you can look through an audit log on Notion and view previous versions
Agreed! Love the Ethereum website, it’s brilliant — the only reason I found there were a pile of pull requests for review was because I wanted to contribute to the front end
They just had a community call in their Discord where they talked a lot about creating frameworks for contributors, it sounds like they are making pushes towards bringing in more of the community to help maintain the website; more than 1000 people have contributed to the website (this number probably counts other repos as well)
Wow. Impressive that 1,000 individuals have contributed to the Ethereum Foundation (EF) site. That’s awesome the EF is thinking about building frameworks for future contribution.
My question on version control is not on whether you can look at the Notion history. Rather, if you can push and pull commits to a GitLab/GitHub repository. I’ll explore and test this further. @links may have experience with this too.
I’ll research the API docs further and follow-up on their StackOverflow, Slack, Twitter, and support email.
After building my first HackMD page (hackmd.io/@openinfo/hackmd) the published UX is better than Notion’s because of its ability to adapt to any screen size.
HackMD is the only platform so far where I can easily copy and paste published content. I’m having issues on other platforms in Firefox with highlighting content with texts and links.
The hybrid GUI/Markdown editor allows direct access to the Markdown which is powerful for customization beyond other platform’s GUIs for colors, themes, templates, and etc.
Next I’ll refactor the HackMD page to a Book view to test out multi-pages and the collapsible navigation menu.
It could be a good opportunity to grow alongside their small and effective team.
I am enjoying GitBook more that I discovered their Editorial Page Layout that has 1 sidebar for the ToC instead of 2 sidebars including an additional navigation menu. I’ve updated the sample above to include this.
An issue is GitBook’s ToC disappears unless the window is almost completely expanded in the published view so many users will likely miss this component.
My assumption is that the version control system (VCS) is important in the long-term for automating tasks and for decentralization. With continuous integration (CI)/ continuous deployment (CD) tools we could auto-deploy to platforms like Arweave and IPFS in the future.
DAO collaborates on content in a Markdown based app, e.g. HackMD, Notion, Gitbook, Skiff, and etc.
Commits from the app are pushed to a VCS feature branch.
The feature branch is merged to a release branch.
The release branch auto deploys the changes to Arweave/IPFS for updating the publicly available content.
My recommendation is that we move the Safe Open Guide to Github.
Many people are already familiar with Github’s UX and already have a Github account
Content on Github is open-source and version controlled so there is no lock-in and we can export to another format in the future.
Github is very popular so there are more tools that we can use for Github integration (Zapier, Notion etc.)
HackMD is a fne tool for people already in the blockchain ecosystem but for people less familiar I feel like it’s another point of friction and increases barrier for entry for more people to collaborate.
Look into tools to allow syncing content between Github and other no-code solutions like Notion.
I think it’d also be really cool as a next step if Github was the canonical source of truth for the content but we also allow for 2-way syncing with no-code tools like Notion. For example, people could browse the content in Notion and also allow people to contribute to the open guide using Notion’s popular WYSIWYG editor.
The most important thing is effectively coordinating across the core Safe team, SafeDAO, and community. I’m looking forward to merging the existing open notes with whichever platform we decide on.
Version control systems (VCS) two-way sync
I agree on optimizing for a Markdown tool that works seamlessly with VCS two-way sync.
Allows for automating backups
Allows contributors to use their client of choice.
Those comfortable with Markdown + Git can write custom Markdown and submit pull requests with their editor of choice.
Beginners can write directly in a WYSIWYG editor.
Future optionality to auto-publish with custom hosting
GitHub makes sense in order to optimize for current developer adoption.
“We can export to another format in the future.”: I like this idea.
GitLab: Dedicated to open-source/open-core
Radicle.xyz: Open-source + working on decentralization
Thank you for pointing me in the right direction for Notion<>GitHub syncing. Scanning the Notion docs so far I did not see a native way to implement GitHub two-way sync. I’ll start with these resources and explore further to see if a seamless workaround can be made.
Overall, I enjoy both the final published version and editing experience of Notion over GitBook. Although, not as much as HackMD for each category. Notion could be a good balanced option given two-way VCS sync is possible.
GitBook and HackMD
Both platforms currently have VCS two-way sync.
I parsed through the Notion<>GitHub workaround links above. Unfortunately, they evolve around syncing GitHub issues with Notion whereas we’re looking to push and pull our Markdown .md files with GitHub. This still might be possible with a custom API integration, but so far it seems it would not be as seamless as GitBook or HackMD for two-way sync.
As @tomiwa1a, @theobtl, and I have discussed, the next version of the proof-of-concept open info (OI) for Safe and SafeDAO have been created in GitHub with Markdown. I’ve further experimented with HackMD’s published UI which is synced to each GitHub repository in HackMD’s app.
Migration to Safe resources
I can incrementally submit pull requests to merge the content from the open info into core Safe team/SafeDAO resources.
I’m happy to migrate the Markdown files from the repositories (repos) below to the SafeDAO team’s repos once they’re created.
I’ve also created HackMD public teams for Safe and SafeDAO that can have an unlimited amount of contributors. I can transfer ownership of these team accounts too given the relevant email address(es) of the core team.
Minor update: I’ve updated the naming convention from “open guides” (OG) to “open info” (OI).
“Guide” seems to suggest providing advice and feels more appropriate for a centralized entity. The vision is to move towards more open and decentralized collaboration which is potentially better fitting for the naming convention of “open information” (OI).