Package Name

[MichaelHatherly]

Re: MichaelHatherly/Docile.jl#147 (comment), cc @hayd

Currently just a placeholder name, though slightly "thematic". See meaning https://en.wikipedia.org/wiki/Lapidary_%28text%29.

Options for name change:

• something simple and unsurprising, i.e. MakeDocs.jl
• a more thematic name, but not too obscure.

[hayd]

I do like MakeDocs.jl... mainly as I like to remember 0 things, and remembering the name of things and their associated meaning is kind of annoying. Also Googleability/surprise.

using MakeDocs... I wonder what that package does?

Said no-one ever.

There's no rush on this, a name change can happen any time before release :)

[MichaelHatherly]

There's no rush on this, a name change can happen any time before release :)

👍

[tshort]

I like MakeDocs.jl, and I'd rather see the change sooner rather than later. Maybe it's worth opening a [BikeShed] issue on METADATA with whatever name you want to go with. I don't remember seeing that done before, but it might help get that part out of the way.

[MichaelHatherly]

Yes, probably worth doing that soonish.

[nalimilan]

+1 for an explicit name like MakeDocs.jl. (One could think about DocsMaker, DocsBuilder, DocsGenerator...).

[MichaelHatherly]

Another option, Documenter.jl.

[hayd]

Manualfacturer.jl

[MichaelHatherly]

Manualfacturer.jl

Nice! :)

[MichaelHatherly]

I'm leaning towards Documenter.jl since it seems, to me at least, to be a pretty self-explanatory name and nice and simple to remember. Also matches other recent package namings such as Maker.jl. As far as I can tell it covers @hayd's point

remembering the name of things and their associated meaning is kind of annoying

and doesn't squash together several words like the Docs* names do, which I'm not really a fan of doing if possible.

I could still get behind Manualfacturer.jl if I can manage to type it without making any typos.
@tkelman, was that a vote in favour of @hayd's name?

[tshort]

+1 for Documenter.jl.

[tkelman]

Yes because I like the pun, but it would be easy to mistype. Documenter works too.

[nalimilan]

+1 for Documenter too.

[hayd]

I was joking/not serious about Manualfacturer!

+1 for Documenter.jl.

[MichaelHatherly]

Thanks all, I'll probably rename on Sunday barring any better suggestions.