OpenChain-Project / Reference-Material

This repository contains the reference material related to the OpenChain Project
Other
71 stars 56 forks source link

[Improvement] Supplier Leaflet: Steve - This seems very long, overall. I think there's scope for something much shorter and punchier. #65

Closed shanecoughlan closed 6 months ago

shanecoughlan commented 6 months ago

This seems very long, overall. I think there's scope for something much shorter and punchier.

shanecoughlan commented 6 months ago

As discussed on the call 2024-02-27, let's look at two things:

(1) There is a known use case of suppliers being sent a completed, formatted leaflet version of this document to learn about open source management and compliance issues (etc). In some areas like Japan that tends to result in a physical print-out and review. Our larger leaflet format fits this market segment well.

(2) There is known use case of quick infographics or small handouts that help get people orientated.

This source material could potentially be both, if we consider the text as open to being made more modular and each modular being broken down to small sections as needed.

So perhaps this fits under "refactoring may be good, let's work on that"?

@jacobdjwilson is going to take a look at this :)

shanecoughlan commented 6 months ago

Leaflet: https://github.com/OpenChain-Project/Reference-Material/blob/master/Education-For-Suppliers/Supplier-Education-Leaflet/supply-chain-education-leaflet-version-2-2024/supply-chain-education-leaflet-version-2_en.md

jacobdjwilson commented 6 months ago

I have added a table of contents ahead of the Introduction section similar to the original PDF leaflet. In addition I slightly modified two headings to be more succinct.

OLD: What you need to do to receive the benefits of open source NEW: Receiving the benefits of open source

OLD: Open source information required to be delivered with software NEW: Delivery of open source software

PR 70

shanecoughlan commented 6 months ago

Fixed here by @jacobdjwilson