Hi Brent, Glad to hear that. Yes. Please submit a PR for the doc, we will help you review.
Best, Junkai On Mon, Nov 30, 2020 at 4:11 PM Brent <brentwritesc...@gmail.com> wrote: > Hey all, > > I wanted to gauge interest in constructing a page (possibly something that > lives under https://helix.apache.org/*-docs/index.html) that explains the > various Apache Helix configuration parameters including their scopes (e.g. > CLUSTER/RESOURCE/INSTANCE), their default values and descriptions. I ended > up constructing a first pass for my own consumption and figured it might be > useful to other Helix users as well. > > I don't mind generating a first draft and sharing it (though I do need to > get approval for that first), but I'll very likely be missing information > or be wrong on certain things so it will definitely require proofreading > from more knowledgeable folks (i.e. you all). It would be cool if we could > auto-generate it from the code so it didn't need to be updated separately, > but I'm not sure how feasible that is at the moment so this seemed like the > next best bet. This is more of a Zookeeper-level description at the moment; > it doesn't currently reference the corresponding Java objects/methods. > > A very minimal sample formatted in Markdown is below (pasted into your > Markdown previewer of choice). Thoughts? > > | Param Name | Scope | Deprecated | Default Value | Description | > | ----------- | ----------- | ---------- | ------------- | ----------- | > | DELAY_REBALANCE_TIME | CLUSTER | No | -1 | Delayed time that Helix should > hold off for until rebalancing (in milliseconds). Only valid when > DELAY_REBALANCE_ENABLED is true. | > |...| ... | ... | ... | ... | > | MAX_PARTITIONS_PER_INSTANCE | RESOURCE | No | Integer.MAX_VALUE | The > maximum number of partitions, for the given resource, that can be placed on > any single instance. | > |...| ... | ... | ... | ... | > | DOMAIN | INSTANCE | No | null | Domain represents a hierarchy identifier > for an instance. The value should mirror the TOPOLOGY setting for the > cluster. See > > https://engineering.linkedin.com/blog/2017/07/powering-helix_s-auto-rebalancer-with-topology-aware-partition-p > . > | >