boris
July 9, 2022, 6:06am
1
Note: time / space is TBD. Sign up that you’re interested / want to attend and then we’ll update with the final date / time / room
The IPFS Awesome List needs rebooting!
From a thread with @lidel :
We should talk about this at IPFS Thing. It’s embarrassing how old and broken many of the links are on that site.
I’m putting this in as a placeholder session that is a call for participants. I want to scheme with @lidel about this, please join us / leave a comment / follow this post if you’re interesting in participating.
Time and place TBD as we figure out how to fit in ad hoc sessions into the schedule.
2 Likes
mosh
July 12, 2022, 10:39am
2
I’m interested in joining.
There is quite some overlap with ecosystem.ipfs.io (powered by an Airtable form > reviewed by IPFS team) so might be worth discussing that in the same conversation.
2 Likes
boris
July 15, 2022, 5:11pm
3
Awesome
kick out to awesome-ipfs github org?
fund via open collective to the community
make it a simpler actual Awesome List → README
slurp it into ecosystem for a pretty version
IPFS Shipyard
bring up on IPFS Discourse
currently – ephemeral, or temporary, or sample projects
promoted into IPFS → or graduated to its own repo
Ecosystem → airtable?
Merge / integrate scheme between two systems?
Clearly articulate role of Awesome vs Ecosystem?
Github analytics on IPFS project activity?
Where do we want people promoting their awesome hackathon projects?
a “Promo” channel here in Discourse?
moderated
Content is only English
Can we put some of this new stuff and schedule new things on the Explore page of IPFS Desktop?
Can we improve this page?
Can we connect to rest of community? e.g. link to Discourse, Discord, Wikipedia
MAYBE also use Ecosystem / Awesome a source of new info
About Awesome Lists – awesome/awesome.md at main · sindresorhus/awesome · GitHub
Looks like lidel and andrew have commit access
Look at 0Data Apps as another example list of apps → https://0data.app/
Some Takeaways
Ecosystem → this will be “internally” PLN maintained @mosh
Awesome → have community take over
people who participate in protocol work
write implementations
Some questions:
what would be the submission? github repo at least, website optional
categories / status – testers wanted, stale, personal project, beta launch
@boris will ask some other usual suspect PLN companies about contributing – have discussion here in the Discourse forum
2 Likes
boris
July 16, 2022, 3:23pm
4
The Community page in IPFS docs → Community | IPFS Docs – lists Awesome, but doesn’t list Ecosystem.
Generally, this community page needs updates.
Put Docs on the list for “call for add your stuff” from many different apps, companies, networks, and so on.
1 Like
I appreciate the effort to reboot the awesome list.
I can understand the distinction between the ecosystem page and awesome, despite the overlap. Awesome lists are typically more open and community-directed in contrast to the ecosystem list which we curate.
The awesome-ipfs list has been around for a while and has a lot of stale submissions (unmaintained and non-functional, e.g. GitHub - fbaiodias/ipfs-chrome-station: Chrome extension that let's you access IPFS urls seamlessly from your local IPFS node, and take a look at its stats ). Adding a stale category or status would definitely help.
I’ll create a PR to add a link to the ecosystem page too from the IPFS docs.
2 Likes
boris
July 18, 2022, 3:22pm
6
Yep. And unless someone objects, @mosh & @SgtPooki and I suggested focusing on code for Awesome List — so a link to the Source code would be the main focus, and then a project / demo / company / docs website if it exists.
2 Likes
Focusing on code for the awesome list makes a lot of sense and makes the distinction with Ecosystem even clearer.
1 Like
I’ve got an issue where we’re tracking this in the awesome-ipfs repo. Please see Awesome IPFS isn't awesome · Issue #420 · ipfs/awesome-ipfs · GitHub
2 Likes
With regards to the ecosystem page, I made a meta proposal to simplify the submission process.
The goal is to reduce some of the burden on us and ease the process of iterating and providing feedback to submitters.
opened 06:36PM - 03 Aug 22 UTC
kind/discussion
need/triage
## Background
Currently we rely on Airtable as the source of truth for proje… cts in this repo.
The current workflow involves:
1. Reviewing the submissions on Airtable
1. Once the approval checkbox is checked the `json` filed in Airtable is populated with the content from all the fields
1. The JSON is manually copied into a file in this repo [described here](https://github.com/ipfs/ecosystem-directory#transforming-project-data)
## Challenges with the current approach
- When submissions are made to Airtable, there's no easy way to ask the submitters for changes. This puts the burden of editing on us rather than being able to provide feedback and make changes in a single place.
- Making changes requires updating Airtable, having the JSON regenerated and copying over the changes here which is also error prone
- It's not possible to preview how the website looks with new submissions in Airtable
- There's no automated way to check if all the checked projects in Airtable are published in the ecosystem website
- Moving the JSON from Airtable is error prone and requires opening a PR in this repository that also adds the images
- We say that Airtable is the source of truth, but the actual source of truth for the website is this repo.
## Improvement ideas
Some ideas on how we can improve the workflow to reduce friction:
1. Move the submission process directly to this repository. Have a PR/project.json template so that submissions can be submitted and previewed directly here. Could be combined with a tool like https://forestry.io/ for easier editing of content.
1. Have a script to sync between Airtable (using [their REST API](https://airtable.com/api)) and the files in this repository to avoid manually copying JSON. Could probably be in a GitHub action that routinely creates PRs for projects that have been approved/checked.
I'm leaning towards the first suggestion as it resolves many of the challenges mentioned above while reducing complexity significantly.
## Open questions
- Do we still have a case/need for using Airtable? The main reason to use Airtable seems to be to allow non-developers to edit content. This comes with a fair bit of additional complexity which could potentially be avoided.
CC @mishmosh
1 Like
Just for everyone’s info, I’ve made some significant progress automating things for awesome-ipfs. I plan to clean up the open PRs and issues so that we have a more hospitable repo prior to IPFS Camp. Be sure to subscribe to Awesome IPFS isn't awesome · Issue #420 · ipfs/awesome-ipfs · GitHub if you want to keep track of the improvements.
2 Likes
boris
September 16, 2022, 8:14pm
11
Awesome.
I was going to hack on it this weekend. Including that … well, the current structure is too complicated.
Will do it as PRs and see where I get to.