meta
meta copied to clipboard
A community dedicated to supporting tools for technical and scientific communication and interactive computing
I was going to bring this up in meta, since I've started adding `tox.ini` to repositories (see markdown-it-py and myst-parser). Basically tox/nox are very helpful when switching between different repos/projects,...
We are using codecov across a few repositories for our coverage. However we don't have any official practice around using it. Should we agree upon a convention for "how much...
Not sure where the best place(s) to do this is, e.g. README.md, CONTRIBUTING.md, in the RTD docs and also remove/streamline any duplication of the conventions from the repos At the...
Currently, the main source of user feedback is *via* repository specific issues. As the number of issues grow, e.g. in [jupyter-book](https://github.com/executablebooks/jupyter-book/issues), this is not always the easiest to navigate. A...
While contributing to `sphinx-copybutton` I was reading your [dev-conventions](https://executablebooks.org/en/latest/dev-conventions.html), which are really nice 😄 When reading the [communication section](https://executablebooks.org/en/latest/dev-conventions.html#communication) and I saw > Offer encouragement for things done well, don’t...
In https://github.com/sphinx-gallery/sphinx-gallery/pull/690 I learned that Sphinx has some of its own error classes https://www.sphinx-doc.org/en/master/extdev/appapi.html#exceptions I'm curious if anybody has used these before (@chrisjsewell ? @mmcky ?) and if they think...
1. Themes should be consistent across EBP repos documentation. This should in part be achieved by #54, and also it would be good to have a logo for EBP and...
we should probably standardize our docstrings I have been using [numpydoc style](https://numpydoc.readthedocs.io/en/latest/format.html), which looks like this: ``` Parameters ---------- x : type Description of parameter `x`. y Description of parameter...
This is one of the core deliverables from the proposal, to make our output on par with LaTeX. A typical PDF example is shown below. Further comments are given after...
Quick question(s) -- I'd appreciate suggestions/guidance on writing css styles that will work with both ebp and nbconvert for notebook cells/widgets/pages. Does ebp plan to port the notebook less files...