community section update + add stuff about support #1473

ElPaisano · 2023-02-01T20:01:30Z

Draft 👉 https://bafybeibiyrgmm6xz4p3lyhhuyklzrqpojhjdni5422nrtkjedcxyunowse.on.fleek.co/

A second refactor of the Projects / Community section and sidebar menu. Addresses:

Restructures community page into different groups -> https://bafybeibiyrgmm6xz4p3lyhhuyklzrqpojhjdni5422nrtkjedcxyunowse.on.fleek.co/community/
Improve documentation experience related to user support #1469 adds a section getting dev support -> https://bafybeibiyrgmm6xz4p3lyhhuyklzrqpojhjdni5422nrtkjedcxyunowse.on.fleek.co/community/#get-technical-support-and-help
Removes outdated community links (ProtoSchool isn't really a thing anymore, some repos in the main sidebar are no longer active) -> the Projects section sidebar and https://bafybeibiyrgmm6xz4p3lyhhuyklzrqpojhjdni5422nrtkjedcxyunowse.on.fleek.co/community/
Shuffles sidebar menu items around
Adds notes to a few pages about code of conduct and reporting abuse community section update + add stuff about support #1473 (comment)

Goals of this PR:

Improve navigability
Improve grouping
Improve sidebar menu options
Remove outdated / items
Remove as many outbound links from the sidebar menus as possible (bad user experience)
Add info on getting tech / dev support

Checklist before requesting a review

Passing the beta version of the Check Markdown links for modified files check. Action results can be viewed here.

Checklist before merging

Passing all required checks (The beta Check Markdown links for modified files check is not required)

ElPaisano · 2023-02-01T22:33:43Z

Was looking through open issues and realized that Task 1 and Task 2 on #1458 (comment) could also be completed here. So I added note to a few pages RE community code of conduct and reporting abuse

docs/community/README.md

2color · 2023-02-02T13:14:13Z

docs/community/README.md

+- **Discord**: Join the [IPFS Discord server](https://discord.gg/ipfs) for synchronous chat! [Server documentation can be found on Notion](https://pl-strflt.notion.site/IPFS-Discord-Server-Documentation-85bbc451303a473bbf6846b01610e3c1).

-## Meetups
+- **Matrix**: Join the [Matrix space](https://matrix.to/#/#ipfs-space:ipfs.io). [Home server documentation is available on Notion](https://pl-strflt.notion.site/IPFS-Matrix-Homeserver-Documentation-31481e76843547b7ab5160a87eed2b9f).


I don't think the notion page is public

2color · 2023-02-02T13:14:57Z

docs/community/README.md

-## Meetups
+- **Matrix**: Join the [Matrix space](https://matrix.to/#/#ipfs-space:ipfs.io). [Home server documentation is available on Notion](https://pl-strflt.notion.site/IPFS-Matrix-Homeserver-Documentation-31481e76843547b7ab5160a87eed2b9f).
+
+- **Slack**: Join [Filecoin slack](https://filecoin.io/slack) and join the bridged #ipfs channels. The [Filecoin Slack workspace user guide is available on Notion](https://pl-strflt.notion.site/Filecoin-Slack-User-Guide-29072679986b4ccb8ad7b091097dd770).


I don't think this notion page is public either

2color · 2023-02-02T13:15:27Z

docs/community/README.md

+:::

-ProtoSchool isn't just home to interactive tutorials on the decentralized web — it's also a vibrant community of makers and doers around the globe! Community groups worldwide host [ProtoSchool workshops](https://proto.school/events) regularly, offering you the opportunity to complete our interactive tutorials with the support of local mentors.
+- **Discord**: Join the [IPFS Discord server](https://discord.gg/ipfs) for synchronous chat! [Server documentation can be found on Notion](https://pl-strflt.notion.site/IPFS-Discord-Server-Documentation-85bbc451303a473bbf6846b01610e3c1).


Same here — Notion page isn't meant to be public

2color · 2023-02-02T13:20:19Z

docs/.vuepress/config.js

            '/project/repository-guide',
            '/project/related-projects',
            '/project/implementation-status',
-            ['https://github.com/ipfs/roadmap', 'Roadmap'],


Why are we removing the link to the roadmap?

It's not clear to me that this repo is still being used. Last commit was end of October. Is this repo no longer being used for roadmap stuff? Aren't roadmaps individualized to a product now?

I guess that was arising from my naive hope that the roadmap would actually be updated.

Yeah, let's remove it for now.

2color · 2023-02-02T13:23:19Z

docs/.vuepress/config.js

-                  'https://github.com/ipfs/community/blob/master/code-of-conduct.md',
-                  'Code of conduct'
-                ]
+                ['https://github.com/ipfs/notes', 'Research'],


I think this should link to the docs Academic papers page rather than https://github.com/ipfs/notes

2color · 2023-02-02T13:23:32Z

docs/.vuepress/config.js

                ['https://github.com/ipfs/specs', 'Specifications'],
-                ['https://github.com/ipfs/research', 'Research'],
-                ['https://github.com/ipfs/team-mgmt', 'Team org planning'],
-                [


I would still leave the link to the code of conduct in the sidebar menu.

2color · 2023-02-02T13:39:22Z

docs/.vuepress/config.js

-              'https://github.com/ipfs/community/blob/master/code-of-conduct.md',
-              'Code of conduct'
-            ],
+            ['https://github.com/ipfs/notes', 'Research'],


Same thing as https://github.com/ipfs/ipfs-docs/pull/1473/files#r1094526073

2color

LGTM.

The main feedback would be to leave the sidebar link to the code of conduct.

Co-authored-by: Daniel Norman <[email protected]>

ElPaisano · 2023-02-02T16:21:43Z

@2color other than the roadmap repo, I think 809e722 addresses the rest of your feedback

ElPaisano · 2023-02-02T16:23:54Z

Confirming that this PR has no spelling issues (Vale is flagging special terms, need to update word list) or broken links

ElPaisano · 2023-02-02T16:26:18Z

@TMoMoreau @TheDiscordian since this has already had one approving review / been checked fro the writing things, I'm going to ship this as is. Please feel free to comment here if you have any other concerns and I'll address them

ElPaisano · 2023-02-02T18:23:15Z

@walkerlj0 didn't get a chance to mention this in the working group - this PR (merged) updates https://docs.ipfs.tech/community/

TLDR:

Adds info on getting tech support
Rearranges menu items
Removes outdated items and copy

ElPaisano added 2 commits February 1, 2023 12:00

Initial commit

9cc5241

Maybe fix build failure, link to chat section

a171065

ElPaisano self-assigned this Feb 1, 2023

ElPaisano requested review from 2color, TMoMoreau and TheDiscordian February 1, 2023 22:02

ElPaisano added this to the 1/27/23 - 2/3/23 milestone Feb 1, 2023

ElPaisano linked an issue Feb 1, 2023 that may be closed by this pull request

Improve documentation experience related to user support #1469

Closed

More

02177f1

ElPaisano mentioned this pull request Feb 1, 2023

Add a "report abuse" resource to the docs somewhere #1458

Closed

link fix

4b097d4

ElPaisano marked this pull request as ready for review February 1, 2023 22:44

ElPaisano added the need/discussion label Feb 2, 2023

2color reviewed Feb 2, 2023

View reviewed changes

docs/community/README.md Outdated Show resolved Hide resolved

2color reviewed Feb 2, 2023

View reviewed changes

2color approved these changes Feb 2, 2023

View reviewed changes

ElPaisano and others added 2 commits February 2, 2023 09:03

Typo

6feb0d8

Co-authored-by: Daniel Norman <[email protected]>

Remove notions, add code o conduct, Research links to Academic papers

809e722

ElPaisano removed request for TMoMoreau and TheDiscordian February 2, 2023 16:22

ElPaisano merged commit 7a710b9 into ipfs:main Feb 2, 2023

community section update + add stuff about support #1473

community section update + add stuff about support #1473

Uh oh!

Conversation

ElPaisano commented Feb 1, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Draft 👉 https://bafybeibiyrgmm6xz4p3lyhhuyklzrqpojhjdni5422nrtkjedcxyunowse.on.fleek.co/

Checklist before requesting a review

Checklist before merging

Uh oh!

ElPaisano commented Feb 1, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

2color Feb 2, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

2color left a comment

Choose a reason for hiding this comment

Uh oh!

ElPaisano commented Feb 2, 2023

Uh oh!

ElPaisano commented Feb 2, 2023

Uh oh!

ElPaisano commented Feb 2, 2023

Uh oh!

ElPaisano commented Feb 2, 2023

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ElPaisano commented Feb 1, 2023 •

edited

Loading

ElPaisano commented Feb 1, 2023 •

edited

Loading

2color Feb 2, 2023 •

edited

Loading