Skip to content

Commit 8314464

Browse files
docs: update the README
Also, change the spelling of some words to British English
1 parent a87c630 commit 8314464

File tree

6 files changed

+16
-18
lines changed

6 files changed

+16
-18
lines changed

Cargo.lock

+1-1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "practicestuff"
3-
version = "0.1.5"
3+
version = "0.2.0"
44
description = "Simple CLI trainer for improving calculation and memorisation skills"
55
authors = ["Bartłomiej Jaszczak"]
66
repository = "https://gitlab.com/bartekjaszczak/practicestuff"

README.md

+8-10
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@ This is a work in progress and not all functionalities may function correctly (o
44

55
# practicestuff
66

7-
**practicestuff** is a CLI app designed to help you practice skills by asking questions and checking your answers. At the end, you'll see a number of correct answers, as well as some statistics. You can stop early by pressing `Ctrl+C`.
7+
**practicestuff** is a CLI app designed to help you practise skills by asking questions and checking your answers. At the end, you'll see a number of correct answers, as well as some statistics. You can stop early by pressing `Ctrl+C`.
88

99
The application should work on all platforms.
1010

1111
List of skills:
1212

1313
- powers of a number
14-
- multiplication table (times table) (not yet implemented)
14+
- multiplication table (times table)
1515
- doomsday algorithm (not yet implemented)
1616

1717
## Configuration options
@@ -26,11 +26,15 @@ The application is somewhat configurable. Following options are available:
2626

2727
### Powers
2828

29-
Allows to practice powers. Configurable parameters include:
29+
Allows to practise powers. Configurable parameters include:
3030

3131
- base (default: 2)
3232
- exponent range (default: 1-16)
3333

34+
### Times table
35+
36+
Allows to practise multiplications. Factors' range is configurable (default: 1-10 (regular times table)).
37+
3438
# Development
3539

3640
## Initial assumptions
@@ -57,12 +61,6 @@ Allows to practice powers. Configurable parameters include:
5761
- question generation w/ options
5862
- tests
5963

60-
### Multiplication table
61-
62-
- help & usage prompts
63-
- question generation w/ options
64-
- tests
65-
6664
### Improvements
6765

6866
- coloured output (termcolor?) with --no-color option
@@ -72,6 +70,6 @@ Allows to practice powers. Configurable parameters include:
7270

7371
## What's next & bug reports
7472

75-
The application in its current state suits my needs, but I'm open for proposals, either for new skills to practice or more configurability. If you feel that the app lacks something, feel free to open an issue or a PR! I'd be more than happy.
73+
The application in its current state suits my needs, but I'm open for proposals, either for new skills to practise or more configurability. If you feel that the app lacks something, feel free to open an issue or a PR! I'd be more than happy.
7674

7775
As for the bugs, there are some for sure. If you see one, report it!

src/application.rs

+3-3
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ pub const APP_NAME: &str = env!("CARGO_PKG_NAME");
1616
const VERSION: &str = env!("CARGO_PKG_VERSION");
1717

1818
const COMMANDS: [help::Command; 2] = [
19-
help::Command::new(powers::CMD, "Practice powers (configurable base)."),
20-
help::Command::new(times_table::CMD, "Practice multiplication table."),
21-
// help::Command::new(doomsday_algorithm::CMD, "Practice the Doomsday algorithm."),
19+
help::Command::new(powers::CMD, "Practise powers (configurable base)."),
20+
help::Command::new(times_table::CMD, "Practise multiplication table."),
21+
// help::Command::new(doomsday_algorithm::CMD, "Practise the Doomsday algorithm."),
2222
];
2323

2424
pub struct Application;

src/skill/powers.rs

+1-1
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ impl Powers {
9696
.default_value()
9797
.to_string();
9898

99-
format!("Practice powers with a customizable base and exponent range. By default, the base is {default_base}, with exponents ranging from {default_lower_boundary} to {default_upper_boundary}.")
99+
format!("Practise powers with a customisable base and exponent range. By default, the base is {default_base}, with exponents ranging from {default_lower_boundary} to {default_upper_boundary}.")
100100
}
101101

102102
fn build_arg_definitions() -> Vec<Arg> {

src/skill/times_table.rs

+2-2
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ impl TimesTable {
9292
}
9393

9494
fn usage() -> String {
95-
format!("Usage: {APP_NAME} [option]... times_table [timestable_option]...")
95+
format!("Usage: {APP_NAME} [option]... times_table [times_table_option]...")
9696
}
9797

9898
fn help_prompt() -> String {
@@ -115,7 +115,7 @@ impl TimesTable {
115115
.default_value()
116116
.to_string();
117117

118-
format!("Practice multiplication table with a customisable factor range. By default, the factor range mimics the normal times table ({default_lower_boundary}-{default_upper_boundary}).")
118+
format!("Practise multiplication with a customisable factors' range. By default, the range of factors mimics the normal times table ({default_lower_boundary}-{default_upper_boundary}).")
119119
}
120120

121121
fn build_err_message(msg: Option<String>) -> String {

0 commit comments

Comments
 (0)