Skip to content

Add a link to the discussion forum in each of our repositories #835

@choldgraf

Description

@choldgraf

Context

We recently got some great feedback about challenges to contributing to the project. One piece of feedback was that there is not much visibility to the discussion form (link below):

There are only a few places where we link to this forum, and it's not easy to get there from every other documentation site.

Proposal

We should provide a link to the discussion forum on every page of our documentation. This could either be an "icon" or it could be a toctree-style link. I think there are two potential ways we could do this:

  • Create an "executablebooks theme" and deploy that in our documentation sites. This way we could unify the look and feel of our documentation across all projects, and include some standard information about each in a shared header. This is similar to what the Dask documentation does.
  • Hard-code an icon or link to the docs in each documentation page. This would give us more flexibility to do it as we wish, but it would also be duplicated work.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions