<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hello All,<div class=""><br class=""></div><div class="">I keep getting a 500 error when trying to submit a gitlab issue so ill just post it in here :(</div><div class=""><br class=""></div><div class="">Per major group the index is split into difficulty level, but these distinctions are ultimately either meaningless (as you need both  beginner or intermediate to perform basic tasks, or act more as artificial gatekeepers than meaningful guides. There can be more meaningful distinctions; off the top of my head for example "Create/Destroy", "Modify", "Core" "Util". Lets say for `vec`:<br class=""><br class="">```<br class="">Create - Routines to initialize data structures<br class=""><br class="">VecCreate<br class="">VecCreateMPI<br class="">VecCreate<br class=""><br class="">Modify - Routines to alter behavior or data structure elements<br class=""><br class="">VecSetFromOptions <br class="">VecSetValues<br class="">VecSetLocalSize<br class="">VecSeteLTOG<br class=""><br class="">Core - Core routines to perform intended actions <br class=""><br class="">VecAXPY<br class="">VecWAXPY<br class="">VecMDOT<br class=""><br class="">Util - Routines to perform general actions <br class=""><br class="">VecChop<br class="">VecCopy<br class="">VecAXPY<br class="">```<br class=""><br class="">The point here is that this gives the reader a far better understanding of the "flow" for using various data structures. If I'm new and I want to do some action in PETSc then I want to very quickly get a general sense of how things are done. A fantastic example would be DM, which has gotten so big that you can now do a __ton__ of stuff with it that transcends the usual easy-medium-hard-nightmare difficulty levels we currently attribute to it. You can easily split that into say “create/destroy”, “solver”, “geometry” etc.</div><div class=""><br class=""></div><div class=""><div class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div>Best regards,<br class=""><br class="">Jacob Faibussowitsch<br class="">(Jacob Fai - booss - oh - vitch)<br class="">Cell: (312) 694-3391</div></div>

</div>

<br class=""></div></body></html>