Skip to content

Commit a13560b

Browse files
authored
Merge pull request Raku#202 from JJ/master
Solution for issue Raku#72: spin off module publishing tutorial in the documentation. No one has spoken against, or actually seem to care, so I guess I could as well merge it.
2 parents dd5529c + b0601e0 commit a13560b

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

solutions/ecosystem-versioning.md

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Ecosystem versioning
2+
3+
This is a proposal to solve [versioning issues in the p6c ecosystem](https://github.com/Raku/problem-solving/issues/72).
4+
5+
## Proposed solution
6+
7+
Right now, [distributing modules](https://docs.raku.org/language/modules#Distributing_modules) is but a section in the tutorial that explains modules. This means it's not as well indexed as it should, and the documentation on META6.json should probably be revised and improved. This proposal involves creating an exclusive "Releasing your module", spinning that section off `modules`, in the following steps.
8+
9+
1. Revise thoroughly all steps involved, from the definition of the different keys of the META6.json file, to other underdocumentaed parts like how to use a build phase. I have created [this issue](https://github.com/Raku/doc/issues/3439) to address that previous work.
10+
2. Spin off to a `create-module` file, that includes that revised version as well as documenting how to have several versions released to the ecosystem at the same time either hosted at CPAN or at the ecosystem. That would pick up [suggestions made here](https://github.com/Raku/problem-solving/issues/72). A new issue in the doc repo will be created to do this.

0 commit comments

Comments
 (0)