Conversation
Most of them apparently got broken when pages from language/making-modules were moved to language/distributions
Contributor
|
@schultzdavid Thanks! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A number of links have become dead, probably through the great organization overhaul (PR 4570 in response to Module / Package documentation is structured suboptimally #3714). This should fix most if not all of them.
While looking at any individual page, it's hard to tell where it fits in the overall context, or where to find what one is looking for if it isn't there. That's why I've copied the overview section from the bottom of using-modules/introduction (with fixed links, of course) to every other page. That's the big block starting with
=head1 Documentation about Modulesadded to the bottom of most files.Furthermore, I have
There's still a lot to do, but I'd like to get this "structure cleanup" merged first. It's good to go from my side.
Some Todos for later:
usefirst, above the more technicalneed, in using-modules/code, and add a section onimport. In the section aboutrequire, briefly state how to a conditionally load a module into the right scope, along the lines of this SO question and e.g. raiph's reply.Also, the alphabetic ordering of the index of Tutorials is suboptimal for the modules pages, since it makes the advanced topics Distributions and Making Modules come first and the beginner topics Using Modules at the end, with the beginner introduction page sitting very inconspicuously in the middle (using-modules/introduction, listed there as "Modules"). Also, I'd say that all the pages about modules (whatever their internal arrangement) are definitely worth their own subsection in or beside this Tutorials index.