stratis-docs

stratis-docs copied to clipboard

There seem to be doc xml tags which we might prefer to use to annotate the XML data that we publish

2

I found this out when looking at the contents of /usr/share/dbus-1/interfaces/

mulkieran

It would be a good idea to document what would be the increased risk of failure resulting from selecting a subset of available blockdevs to write metadata to

2

mulkieran

Child of https://github.com/stratis-storage/project/issues/495

mulkieran

Cache a built version of zola for CI

2

We could maybe use a containerized zola, or we could find some way that GitHub can cache the built zola between runs of our CI. It builds just fine in...

mulkieran

Update how-to to reflect the actual state of affairs regarding boot from root

2

We can let https://stratis-storage.github.io/stratis-rootfs/ be our guide.

mulkieran

Define "cap device"

1

We don't have a clear definition in our documentation about what the cap device is. I'm thinking something along the lines of: "The cap device is the device on top...

jbaublitz

Document idempotence of D-Bus API in design docs

3

This is mentioned in the D-Bus docs but not in the design docs.

jbaublitz

FAQ request

2

I was reading the 1.0 release note in LWN and someone commented about the risk of ending with "poor layout" because of continuous growing ([link](https://lwn.net/Articles/767437/)). The OP cited an answer...

mmoya

Ref. https://bugzilla.redhat.com/show_bug.cgi?id=1662391

tasleson

It would be a good idea to document what we do know about the correctness of our metadata handling

1

Right now, we know this: 1. When a BDA is first initialized, it has no variable length metadata. That is correct. We assume that after setup, the BDA has variable...

mulkieran