Documenter doesn’t generate any directory indexes
Yes, I should have written: See my [tutorial](tutorial/README.md) folder.
should just be `[...](tutorial.md)`.
Yes, this working, but initially I did not want to do that because markdown files in ./docs/src should be considered as .md.jl files but not as pure .md files since they can have Documenter tags such as @ref @docs and use relative links. My tutorials markdown files do not hold Documenter tags that was my main concern (+ the fact that ./docs/src is too hidden in my taste).
Therefore, you have to choose between having good urls with markdown files (./tutorials) or the having good urls with generated code (./docs/src + [...](tutorial.md)). No escape! So in my make.jl code, after having copied my md files, I have to do some search and replace job such as:
replace "[tutorials](tutorial)" => "[tutorials](tutorial.md)"
and this is working. My ugly code:
infile = normpath(@__FILE__, "../../README.md")
outfile = normpath(@__FILE__, "../src/index.md")
out = open(outfile, "w+")
for line in readlines(infile)
newline = replace(line, "[tutorials](tutorial)" => "[tutorials](tutorial.md)")
write(out, newline * "\n")
end
close(out)