search

Raku / doc

🦋 Raku documentation
https://docs.raku.org/
Artistic License 2.0
287 stars 291 forks source link

Uniform file names in the Languages directory #2244

Open JJ opened 6 years ago

JJ commented 6 years ago

The problem

When the filename includes two words, _ and - are used indistinctly: grammar_tutorial and io-guide, for instance.

Suggestions

It wouldn't be good to change URLs now since we would lose lots of links, but we might want to decide on a uniform way of separating words in file names and, if names are changed, create redirections. While we're at it, we might want to give uniform names to "tutorials", "guides", and "howtos". There's an IO "guide" and a grammars "tutorial". There are also Python, Ruby and other "nutshell", but a Haskell-to-p6. Underscores are only used in 3 files. We might want to change those three names and include indirections in the .htaccess file. Dashes are better than underscores, too.

coke commented 1 year ago

@finanalyst - I want to create subfolders for the language pages, and also have redirects for anything we move; how hard is this for doc-website to track?