Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation of packaged executable #348

Open
10 tasks
ibnesayeed opened this issue May 11, 2017 · 4 comments
Open
10 tasks

Documentation of packaged executable #348

ibnesayeed opened this issue May 11, 2017 · 4 comments

Comments

@ibnesayeed
Copy link
Contributor

ibnesayeed commented May 11, 2017

When the OpenWayback source is built using mvn package, build artifacts include a bin directory that contains various executable scripts. Only the cdx-indexer tool is mentioned in the documentation (without much details of its usage and options available). It would be nice to have a wiki page that describes each executable briefly.

I have added a wiki page and populated it with all the packaged scripts and their CLI usage output. However, each utility needs some description and the purpose as the CLI usage documentation is often not very helpful.

  • bdb-client
  • bin-search
  • cdx-indexer
  • cdx-sample
  • create-test-arc
  • location-client
  • url-client
  • warc-header
  • zipline-manifest
  • zl-bin-search
@ldko
Copy link
Member

ldko commented May 11, 2017

@ibnesayeed do you want to do the documentation?

@ibnesayeed
Copy link
Contributor Author

@ldko, I really don't know much about those tools. However, I can create a template page where I would list all the tools that are provided, then someone can fill in the details.

@ldko
Copy link
Member

ldko commented May 11, 2017

@ibnesayeed ok, when you do that, if you want to also make a checklist on this issue of which tools need documentation, so we can check them off as they are done, that would be helpful too. Thanks!

@ibnesayeed
Copy link
Contributor Author

ibnesayeed commented May 11, 2017

@ldko, I have updated the first post with a checklist and a link to the newly created wiki page. I have already populated the page with corresponding CLI usage documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants