2020/10/7

[phlax]

past 2 weeks

vscode

• working on dumping schema (Make it easier to build docs envoyproxy/envoy#13229)
• resolved pattern for expressing typed_config
  • created phlax/typed-config-testing repo to test jsonschema patterns with vscode
• working on protobuf -> jsonschema
  • created phlax/protobuf2dev repo
  • tested basic functionality of https://github.com/chrusty/protoc-gen-jsonschema
  • learning bazel/starlark/testing(skylib)
  • learning rules_proto
  • figuring out bazel pattern

docs

• make docs easier to build (Make it easier to build docs envoyproxy/envoy#13229)
  • update related docs (docs: Update build instructions for docs envoyproxy/envoy#13268)
  • repokitteh docs command/events ([WIP] repokitteh: Add message when docs change/render in PR envoyproxy/envoy#13326)
• docs updates/cleanups
  • structured headers in sandboxes (docs: Use structured headings for examples steps envoyproxy/envoy#13292)
  • tabbed blocks (Add Sphinx tab renderer to documentation envoyproxy/envoy#13213)
• started preliminary work on:
  • TLS sandbox (sandbox: TLS sandbox envoyproxy/envoy#13373)
  • improve docker/kubernetes docs (Improve documentation around running Envoy in Docker container envoyproxy/envoy#13408)

continuous integration

• automate example/docs config validation ci
  • tests: Move configuration file count to constant envoyproxy/envoy#13202
  • docs/ci: Update config validation envoyproxy/envoy#13387
• mac ~fix
  • ci: Add retry loop for brew commands envoyproxy/envoy#13348

community/onboarding

• automate common problem resolutions with repokitteh
  • welcome: repokitteh: Add welcome message for new contributors envoyproxy/envoy#13309
  • dco: [WIP] repokitteh: Add DCO nag on Pull Requests envoyproxy/envoy#13325
• some channel support
• pr reviews as requested/relevant

security

• detected issues with CI/pipeline/publishing api key integrity with repokitteh
• aware of other potential similar issue with other parts of CI

shellcheck

• complete linting
  • Shellcheck: ci/ (2) envoyproxy/envoy#13169
  • Shellcheck: bazel/ examples/ and other remaining linting issues envoyproxy/envoy#13106
• update shellcheck
  • Update shellcheck in CI envoyproxy/envoy#13228
  • ci: Update shellcheck and build image hashes envoyproxy/envoy#13362
  • shellcheck: Update to v0.7.0 envoyproxy/envoy-build-tools#103

miscellaneous

• non-security repokitteh issues
  • see here https://github.com/repokitteh/modules/issues

next 2 weeks

crack protobuf -> jsonschema (hopefully)

play with tooling a bit more, so i am more confident with how the parts work, and more able to understand @htuch 's suggestions on how to integrate with envoy ci (envoyproxy/envoy#13283 (comment)).

work on documentation

the main tasks for the tutorial are

• fixing remaining .md -> .rst formatting issues
• fixing config validation/deprecation
• agreeing structure of tutorial section
• work on copy

i would like to get the tutorial section to at least almost-ready-to-deWIP over next 2 weeks.

there are some other general issues with docs (eg config validation/ docker permissions) which i should be able to complete.

i would like to make a suggestion - move dev docs into main documentation, or at least an .rst format where we can validate etc, and they are all in one place - if agreed, i would also like to work on that.

bash cleanups

im aware of quite a bit of code cleanup that can be done beyond conforming with shellcheck, but conscious of using up others' review cycles

miscellaneous

address outstanding issues/prs listed above or open on github.

contribute to resolving raised ci/security issues

blockers

• my knowledge of bazel and protobuf (slowly being addressed)
• repokitteh issues