Github user srowen commented on the pull request:
https://github.com/apache/spark/pull/10491#issuecomment-167759582
I guess my point is that these CLI flags are already documented in the CLI,
as help text.
I can see an argument for formally, separately documenting them in the
website, and/or their relation to other Spark properties if applicable. It's
duplicative and means keeping them in sync, but it's useful. However you'd want
to do that for all or none, I suppose, rather than just a few. Right now I
don't see any existing place for them.
In bits and pieces, the flags are referenced in various parts of the docs.
My suggestion would be to not do this at all, or else, find where similar
arguments are already mentioned in the docs and mention these few additional
ones there. For example `executor-cores` is mentioned a little in
`job-scheduling.md`
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
