InnerSourceCommons / InnerSourcePatterns

Proven approaches that can guide you through applying open source best practices within your organization
https://patterns.innersourcecommons.org
Creative Commons Attribution Share Alike 4.0 International
739 stars 181 forks source link

Generate landing pages for pattern adopters #624

Open spier opened 10 months ago

spier commented 10 months ago

Implements #623

1st implementation approachs:

spier commented 10 months ago

Scenario: create a page with subpages in gitbook like this

* Parent Page
  * [S1](sub-page1.md)
  * [S2](sub-page1.md)

If you don't provide a file for "Parent Page", then gitbook will automatically create a page, where it lists all sub pages. That's kind of nice.

I would like to add some explanation to that parent page though, i.e. to describe what the content on the sub pages is. However I don't know to do that while still keeping the automatic "list all subpages" feature.

spier commented 10 months ago

As part of this I am also experimenting with more visual configuration options of gitbook (see README.md). Not sure yet if this will be part of the finale PR.

gruetter commented 10 months ago

Would you like updates to the adopters pages for specific companies at this point, @spier ?

spier commented 10 months ago

Would you like updates to the adopters pages for specific companies at this point, @spier ?

hi @gruetter. I am still experimenting with this, so I would say let's finish a basic v1 of this that we can launch, and then add content/features.

This raises an interesting point though: Do you mean that you want to be able to customise an individual adopter page? e.g. add some custom content to the Bosch page? If we allow that, this would come with some technical challenges (which I am sure we can fix). Also raises questions about how to review such content, not letting it become purely promotional, etc.

Before getting too worried about possible challenges, can you elaborate a bit about the content that you would like to add? Can you share some examples maybe?