You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As the stdlib modules have grown we have appended functions mostly just to the end of the files this isn't a major problem but as graindoc outputs documentation in order it can make the docs on the website a bit hard to navigate, it would probably make sense to go through our standard library modules and start by grouping related functions such as equality functions, operators and the likes, and then from there it would probably make sense to move more commonly used functions closer to the tops of the modules, this is not quite as straight forward as just ordering the modules though as functions with dependencies on other functions obviously have to come after, and we need to determine what the popular functions are.
Good second issue: The initial ordering so functions are grouped should be easy but it will probably require some discussion. I think we will need furthur discussion as a team about the generalized ordering and importance of functions.
The text was updated successfully, but these errors were encountered:
As the stdlib modules have grown we have appended functions mostly just to the end of the files this isn't a major problem but as graindoc outputs documentation in order it can make the docs on the website a bit hard to navigate, it would probably make sense to go through our standard library modules and start by grouping related functions such as equality functions, operators and the likes, and then from there it would probably make sense to move more commonly used functions closer to the tops of the modules, this is not quite as straight forward as just ordering the modules though as functions with dependencies on other functions obviously have to come after, and we need to determine what the popular functions are.
Good second issue: The initial ordering so functions are grouped should be easy but it will probably require some discussion. I think we will need furthur discussion as a team about the generalized ordering and importance of functions.
The text was updated successfully, but these errors were encountered: