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

Add More Detailed Documentation #12

Open
falhenaki opened this issue Jun 5, 2020 · 3 comments
Open

Add More Detailed Documentation #12

falhenaki opened this issue Jun 5, 2020 · 3 comments

Comments

@falhenaki
Copy link

Hi,
I would really appreciate if you could add more detailed documentation on how to use/run with possibly real examples of what the tool can do. I have been going over the readme/code attempting to understand how to fully utilize the tool but been failing to do so. I think a stronger "how to use" doc would significantly increase UX.

@falhenaki falhenaki changed the title Add More Detailed documentation Add More Detailed Documentation Jun 5, 2020
@4ch12dy
Copy link
Owner

4ch12dy commented Jun 5, 2020

Thanks for your suggestion. But I dont know how to add more detailed docs infact, so I add the example code to show how to use it. Can you give me a case or command that not clear?

@falhenaki
Copy link
Author

Thanks for your prompt response. I'd suggest the following:

  • Begin the Readame with an introduction of what the tool does, what cases it can be used, and what benefit it provides.
  • In the installation instructions, please specify whether the tool should be installed on the iOS device or a PC/Mac
  • Specify why "Tap2debug" is highly recommended, and how it works in conjunction with xia0LLDB.
  • After the installation step, explain how the tool can run and how subsequent commands are to be made. insert a smoke-test. This is a short test-case to make sure installation is successful and the tool can do what it's meant to do.
  • Lastly, commands, please display both input (with arguments if any) and output in your examples.

@4ch12dy
Copy link
Owner

4ch12dy commented Jun 6, 2020

Good suggestions!
I see. In fact, there are many articles of practice to show issh/xia0LLDB/tap2debug using in my blog. But it is in chinese. I will append your suggestions as prosoble if having time.

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