What do we want to see in the next version of ExDoc?

[milmazz]

After the release of ExDoc 0.10 we have introduced new bug fixes and new features. The idea of this thread is to open the discussion about the things that we want to see in the next version of ExDoc.

So far, the following are some of the improvements already done in this iteration:

• Increase the visual separation between functions [Usability] Function headings are not clear #419
• Allow to define the title in the sidebar area for additional content, default: Pages. Allow user define title for additional pages #467
• Allow to define the path and title of each additional page in mix.exs. Allow definition of the path/title for extra files #470
• Use the first h1 as menu title if title is not configured. Use first <h1> as menu title if title is not configured #471
• Remove the extra- prefix for the additional documentation. Get rid of the 'extra-' prefix #462 Get rid of the 'extras-' prefix #468
• Extra large images do not create an overflow in the content. Add a max-width property to img tags #455
• Include the project name as part of the header in small devices. [Mobile] No sign of what project's documentation we are reading #435 Add project's name in the content on small screens #458

However, there is a lot of work still pending, such as:

• Night mode version for docs. Night mode version for docs #474
• Link icon overlaps with hamburger (in small devices) [Mobile] Link icon overlaps with hamburger #434
• Add history support to the search page [Search] Add history support to the search page #341
• EPUB support (I can complete this feature this weekend) EPUB support #305

What do you think? /cc @josevalim @eksperimental @dignifiedquire

[josevalim]

Thanks @milmazz! Most of those would be really nice improvements, although they should not block it because we already have enough IMO. So I think the big question is if there are any bugs or improvements that are extremely important to include so we focus our efforts on it. :)

[ericmj]

All of these fixes seem enough for it's own release.

[milmazz]

So I think the big question is if there are any bugs or improvements that are extremely important to include so we focus our efforts on it

@josevalim AFAIK there is nothing extremely urgent to fix. Also, as you and @ericmj pointed out, there is a lot of things already done for a new release :-D

I'll send a PR with the updated Changelog.

[josevalim]

Closing then in favor of the CHANGELOG. :D