-
Notifications
You must be signed in to change notification settings - Fork 2.1k
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
docs/*: add overview, op-guide, client #3494
Conversation
Signed-off-by: lilin90 <lilin@pingcap.com>
@queenypingcap PTAL |
overview may be duplicated with readme? |
@siddontang I also noticed that when I commit. I keep it because later we'll maintain a whole set of separate documentation for TiKV and might put them on a separate website page. And all those contents come from here (tikv/docs). Currently, I'll maintain TiKV documentation at TiKV Wiki. |
PTAL @Hoverbear |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
docs/clients/go-client-api.md
Outdated
|
||
## Try the Raw Key-Value API | ||
|
||
To use the Raw Key-Value API in applications developed by golang, take the following steps: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
in the Go language
docs/clients/go-client-api.md
Outdated
Description of two parameters in the above command: | ||
|
||
- `string`: a list of PD servers’ addresses | ||
- `config.Security`: used for establishing TLS connections, usually left empty when you do not need TLS |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is it expected that the user will understand how to set up TLS here if they want it?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes.
docs/clients/go-client-api.md
Outdated
|
||
- Transaction | ||
|
||
Like the Transaction in SQL, a Transaction symbolizes a series of read and write operations performed within the Storage. Internally, a Transaction consists of a Snapshot for reads, and a MemBuffer for all writes. The default isolation level of a Transaction is Snapshot Isolation. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Like transactions in SQL
- CentOS 7.3 (64 bit) or later with Python 2.7 installed, x86_64 architecture (AMD64) | ||
- Network between machines | ||
|
||
> **Note:** When you deploy TiKV using Ansible, use SSD disks for the data directory of TiKV and PD nodes. Otherwise, it cannot pass the check. For more details, see [Software and Hardware Requirements](https://github.com/pingcap/docs/blob/master/op-guide/recommendation.md). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we can have a better reason than this. Maybe "Otherwise, the system will not perform well."
Signed-off-by: lilin90 <lilin@pingcap.com>
0a17da0
@siddontang @zhangjinpeng1987 @Hoverbear PTAL again. Thanks! |
* docs/*: add overview, op-guide, client Signed-off-by: lilin90 <lilin@pingcap.com>
Signed-off-by: lilin90 lilin@pingcap.com
What have you changed? (mandatory)
Add the following TiKV documents:
Does this PR affect documentation (docs/docs-cn) update? (mandatory)
Relevant.
Does this PR affect tidb-ansible update? (mandatory)
No.