Jody Klymak
Jody Klymak
> This makes no reference to https://diataxis.fr/ . It is a well thought out, documented, and widely used system for organizing the docs. Is this the case? Sorry to question...
I have a pretty different take on the slicing of things. As noted a few times before, our previous organization was largely based around the fact folks wanted to write...
Repeating my objection: I strongly object to relegating the users guide to simply "learning/explanation" and think it needs to show you how to "push the buttons". Ideally the users guide...
> This is sorta why my revised proposal is that the getting started guide does this & is in tutorial form. I feel the Getting Started Guide should be considerably...
> What's the taxonomy here? I'm reading this and seeing the same spectrum we already have where: > > 1. it's not clear why a document is placed where it...
> what's missing from the rubric + tutorial getting started + explanation of concepts in terms of getting to this? As before, your rubric says that "How to push the...
> If the same document can be placed in user guide and examples or examples and tutorials, then that means those sections of the docs aren't serving distinct purposes. Fundamentally...
Just because you can do it, doesn't mean you should ;-) I can get the same effect as that PR just by doing the much more obvious method of copying...
@chahak13 I moved this to draft, if for no other reason than that the tests aren't passing. Do you have enough feedback to proceed, or do we need to make...
I'm not sure why there is such a large margin around axes3d plots. I have a sneaking suspicion that the margin was developed outside the subplot paradigm, which also have...