ToDo.md

Enola 🕵🏾‍♀️ ToDo

High Priority (Next Features)

1. Focus on implementing Applications outlined in mkdocs.yaml

2. Merge this with ToDo.yaml

3. Support top-level namespace: "demo" in docs/use/library/model.textproto and rm others

UI

1. #css Units px -VS- em? Uniform?!

2. #css .app-bar (incl. Help icon) middle alignment how-to?

3. #css Search Bar should be more in the middle, and fill all space

4. #css How to vertical-align: top the "inner" Thing table/s?

5. #feat Collapse Thing value cells on click (perhaps with a [+/-] ?)

6. #dev Resource.watch() etc. with https://github.com/livereload/livereload-js

7. #dev It's ugly how 404.html and other HTML templates duplicate the HTML "frame" - how-to re-use nicely? With Mustache Templates? https://github.com/google/closure-templates/blob/master/documentation/reference/template-types.md#how-do-you-pass-in-a-template

---

Low Priority / Nice To Have

1. Icon based on some Status data from Connector; e.g. 📗 / 📘 / 📙 / 📕

2. https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/

3. LinuxMachine MVP; incl. dmsg Kernel Log analyzer, https://github.com/prometheus/node_exporter reader, etc.

4. Fix mediaType from extension so that e.g. this will work:

   ./enola -v --load=https://raw.githubusercontent.com/enola-dev/enola/main/core/impl/src/test/resources/demo-model.textproto docgen
   

5. Add support for writing and reading ProtobufMediaTypes.PROTOBUF_YAML_UTF_8 - easy, given that YAML is JSON?

6. enola-dev#102 : Enforce https://www.conventionalcommits.org like git commit messages starting with feat/model/fix/build/docs/clean/format/refactor: and core/k8s/tools: using https://github.com/jorisroovers/gitlint

7. CLI completion - hard or trivial?

8. Move common/common/src/[main|test]**/protobuf to common/protobuf (requires ServiceLoader in MediaTypeDetector)

9. https://github.com/google/flogger/tree/master/grpc/src/main/java/com/google/common/flogger/grpc ?

10. Upstream CommandLineSubject to Picocli?

11. unifiedjs.com ?

12. Add to https://github.com/SquadcastHub/awesome-sre-tools

13. https://plugins.jetbrains.com/plugin/10456-prettier ? Or no longer needed, with VSC?

14. Bazel Java IDE support in VSC instead IJ?!

15. docs: Make tools/docs/serve.bash use ibazel to rebuild Proto MD on change of .proto

16. https://github.com/textlint/textlint with https://github.com/textlint/textlint/wiki/Collection-of-textlint-rule

17. dev.enola.common.io.mediatype adapter for https://tika.apache.org/2.7.0/api/org/apache/tika/detect/Detector.html

18. Run mkdocs build instead of in build.bash as a sh_test in Bazel with docs/** + mkdocs.yaml as (only) srcs - fix weird problems

19. Proto design: Is this a real requirement, or can we forget about this: "Note that IDs are not "unique", and 2 different IDs may refer to the same underlying object; for example: k8s:pod?name=echoserver-6dfb6c7764-45gvk&... and k8s:pod?uid=561f1bec-f768-4c5b-b96e-37306d7f2f8a&..."

20. Proto design: Should EntityKind have a "param_parent, to allow grouping common ones, just during declaration in textproto, but inlined for use." or shall we forget about that?

21. Proto design: Should we permit RPC clients to "specify the ID in either (oneof)string text or "broken down" parts form. This is simply for dev convenience in UX such as CLI or Web UIs, and to avoid the proliferation of incompatible parsers. The implementation validates the text, and rejects e.g. "demo:foo?bad=a=b" or "demo:foo?bad=a&bad=b". The string text oneof form is NOT "decoded" like un-escaped (incl. un-quoted) at all, simply "split" ... ? There was IDsTest.java and IDs.java code related to this which I removed on 2023-03-19:

    message ID {
        oneof oneof {
            string text = 1;
            Parts parts = 2;
        }
        message Parts {
            string scheme = 1;
            string entity_kind = 2;
            repeated string segments = 3;
        }
    }