awesome-oss-docs icon indicating copy to clipboard operation
awesome-oss-docs copied to clipboard

Published 20 hours ago • verified publisher icon saintmalik

Split company-supported OSS projects from community ones

Open waldyrious opened this issue 3 years ago • 11 comments

I would love to see a section dedicated to indie/community projects, since those are likely those that need documentation contributors the most, and people looking for open source projects to contribute docs to might want to look at those specifically. I know I would :)

Additionally, maybe we could also consider dividing the large projects into those that are supported by for-profit corporations, and those that are backed by organizations, non-profits and foundations focused on the open source model, e.g. Apache, RedHat, Mozilla, Wikimedia, Linux, etc.

waldyrious avatar Jan 24 '22 18:01 waldyrious

Thats a good idea, it will make sorting easier for people, how can we proceed with that?

saintmalik avatar Jan 25 '22 09:01 saintmalik

I would suggest having two main sections, one for community docs and one for company-backed docs, and the current sections would simply be at a lower heading level under the second section.

waldyrious avatar Jan 25 '22 15:01 waldyrious

Thats great, mind helping with that?

saintmalik avatar Jan 26 '22 12:01 saintmalik

I'd be happy to submit a PR once I get some free time, though to be honest, that may take a while considering my calendar for the next few weeks/months :sweat_smile:

waldyrious avatar Jan 26 '22 17:01 waldyrious

Okay i will find away to get this done, will be free next week, hopefully

saintmalik avatar Jan 27 '22 18:01 saintmalik

I'd be happy to submit a PR once I get some free time, though to be honest, that may take a while considering my calendar for the next few weeks/months 😅

Pushed, please see if it meets the issue request before closing

saintmalik avatar Mar 22 '22 11:03 saintmalik

Hmm, it seems like the changes in 95a87b0cbf4f05f31922b87dad7f508b1c71190f were reverted in de2a23bceaee9b10de272fcf02eab5f5692e0dbb?

waldyrious avatar Mar 24 '22 22:03 waldyrious

Yeah, it was failing the linting test for ToC, do you have any idea on how I can go around that?

saintmalik avatar Mar 26 '22 12:03 saintmalik

Can you link to the logs of one such failing lint run? I tried looking in https://github.com/saintmalik/awesome-oss-docs/actions, but the most recent runs there are from two months ago...

waldyrious avatar Mar 26 '22 18:03 waldyrious

Can you link to the logs of one such failing lint run? I tried looking in https://github.com/saintmalik/awesome-oss-docs/actions, but the most recent runs there are from two months ago...

Yeah, you are correct, the actions was implemented only for pull requests against the main branch and not for my direct push to the main branch.

I would share with you the error from my local host test.

saintmalik avatar Mar 26 '22 20:03 saintmalik

Hello 👋 @waldyrious I think I have found what will work best for this implementation, a live website that has filters?

Check this: https://awesome-oss-docs.herokuapp.com/

saintmalik avatar May 01 '22 12:05 saintmalik

@saintmalik can i close this issue now?

OSCA-Ado-Ekiti avatar Oct 04 '23 19:10 OSCA-Ado-Ekiti