Skip to content

Commit ff0fbae

Browse files
authored
Update all URLs to point to new docs (#493)
- Replace old URLs with new doc URLs in code, README, CHANGELOG. Critical old URLs, for example those printed by gitlint itself in the past, will keep working and redirect to the new URL. - Ensure all links are https (no http) - Fix incorrect top-level doc URL path for user defined rules (rename getting_started.md to index.md). - Replace few accidental uses of jorisroovers.com/gitlint with jorisroovers.github.io/gitlint - Re-enable strict mode in mkdocs
1 parent a19e7d8 commit ff0fbae

29 files changed

+87
-80
lines changed

Diff for: .github/ISSUE_TEMPLATE/issue-template.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ A few quick notes:
1515
1616
- If you can, please include the output of `gitlint --debug` as this includes useful debugging info.
1717
- It's really just me (https://github.com/jorisroovers) maintaining gitlint, and I do so in a hobby capacity. More recently it has become harder for me to find time to maintain gitlint on a regular basis, which in practice means that it might take me a while (sometimes months) to get back to you. Rest assured though, I absolutely read all bug reports as soon as they come in - I just tend to only "work" on gitlint a few times a year.
18-
- If you're looking to contribute code to gitlint, please start here: http://jorisroovers.github.io/gitlint/contributing/
18+
- If you're looking to contribute code to gitlint, please start here: https://jorisroovers.github.io/gitlint/contributing/
1919
2020
-->
2121

Diff for: .gitlint

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[general]
2-
# See https://jorisroovers.com/gitlint/configuration/#regex-style-search
2+
# https://jorisroovers.github.io/gitlint/configuration/general_options/#regex-style-search
33
regex-style-search=True
44

55
# Dependabot tends to generate lines that exceed the default 80 char limit.

Diff for: CHANGELOG.md

+39-37
Large diffs are not rendered by default.

Diff for: CONTRIBUTING.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,5 @@
22

33
Thanks for your interest in contributing to gitlint!
44

5-
Instructions on how to get started can be found on [http://jorisroovers.github.io/gitlint/contributing](http://jorisroovers.github.io/gitlint/contributing/).
5+
Instructions on how to get started can be found on [https://jorisroovers.github.io/gitlint/contributing](https://jorisroovers.github.io/gitlint/contributing/).
66

Diff for: README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# gitlint: [jorisroovers.github.io/gitlint](http://jorisroovers.github.io/gitlint/) #
1+
# gitlint: [jorisroovers.github.io/gitlint](https://jorisroovers.github.io/gitlint/) #
22

33
[![Tests](https://github.com/jorisroovers/gitlint/workflows/Tests%20and%20Checks/badge.svg)](https://github.com/jorisroovers/gitlint/actions?query=workflow%3A%22Tests+and+Checks%22)
44
[![Coverage Status](https://coveralls.io/repos/github/jorisroovers/gitlint/badge.svg?branch=fix-coveralls)](https://coveralls.io/github/jorisroovers/gitlint?branch=fix-coveralls)
@@ -7,9 +7,9 @@
77

88
Git commit message linter written in python, checks your commit messages for style.
99

10-
**See [jorisroovers.github.io/gitlint](http://jorisroovers.github.io/gitlint/) for full documentation.**
10+
**See [jorisroovers.github.io/gitlint](https://jorisroovers.github.io/gitlint/) for full documentation.**
1111

12-
<a href="http://jorisroovers.github.io/gitlint/" target="_blank">
12+
<a href="https://jorisroovers.github.io/gitlint/" target="_blank">
1313
<img src="https://raw.githubusercontent.com/jorisroovers/gitlint/main/docs/images/readme-gitlint.png" />
1414
</a>
1515

@@ -18,7 +18,7 @@ All contributions are welcome and very much appreciated!
1818

1919
**I'm [looking for contributors](https://github.com/jorisroovers/gitlint/issues/134) that are interested in taking a more active co-maintainer role as it's becoming increasingly difficult for me to find time to maintain gitlint. Please leave a comment in [#134](https://github.com/jorisroovers/gitlint/issues/134) if you're interested!**
2020

21-
See [jorisroovers.github.io/gitlint/contributing](http://jorisroovers.github.io/gitlint/contributing) for details on
21+
See [jorisroovers.github.io/gitlint/contributing](https://jorisroovers.github.io/gitlint/contributing) for details on
2222
how to get started - it's easy!
2323

2424
We maintain a [loose project plan on Github Projects](https://github.com/users/jorisroovers/projects/1/views/1).

Diff for: docs/configuration/cli.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Usage: gitlint [OPTIONS] COMMAND [ARGS]...
4949
5050
Git lint tool, checks your git commit messages for styling issues
5151
52-
Documentation: http://jorisroovers.github.io/gitlint
52+
Documentation: https://jorisroovers.github.io/gitlint
5353
5454
Options:
5555
--target DIRECTORY Path of the target git repository. [default:

Diff for: docs/configuration/general_options.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -253,7 +253,7 @@ Path where gitlint looks for a config file.
253253
## extra-path
254254
[:octicons-tag-24: v0.8.0][v0.8.0]
255255

256-
Path where gitlint looks for [user-defined rules](../rules/user_defined_rules/getting_started.md).
256+
Path where gitlint looks for [user-defined rules](../rules/user_defined_rules/index.md).
257257

258258
| Default value | Type | CLI flag | Env var |
259259
| ---------------------- | -------------- | -------------------- | -------------------- |

Diff for: docs/configuration/gitlint_file.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ ignore=T1,body-min-length
126126
on *valid but empty* commit ranges. Disabled by default.
127127
3. Disabled by default, but will be enabled by default in the future. [More information](general_options.md#regex-style-search).
128128
4. See [Contrib Rules](../rules/contrib_rules.md).
129-
5. See [User Defined Rules](../rules/user_defined_rules/getting_started.md).
129+
5. See [User Defined Rules](../rules/user_defined_rules/index.md).
130130
6. All sections below sets rule specific behavior. <br/>
131131
Rules and sections can be referenced by their full name or by id. For example, this rule
132132
`[title-max-length]` could also be referenced as `[T1]`.
@@ -172,7 +172,7 @@ ignore=T1,body-min-length
172172
ignore=all
173173
```
174174

175-
19. [User-Defined rules](../rules/user_defined_rules/getting_started.md) can be written in python to tailor gitlint to your specific needs.
175+
19. [User-Defined rules](../rules/user_defined_rules/index.md) can be written in python to tailor gitlint to your specific needs.
176176
20. [Named Rules](../rules/named_rules.md) allow you to specify multiple instances of the same rule by given them an extra name of your
177177
choosing after the colon sign `:`. <br><br> In the example below we're configuring another instances of the
178178
`title-must-not-contain-word` rule (the existing one will remain active as well) and naming it `Additional-Words`.

Diff for: docs/contributing/contrib_rules.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ itself. Thanks for considering to add a new one to gitlint!
66
Before starting, please read all the other documentation about contributing first.
77
Then, we suggest taking the following approach to add a Contrib rule:
88

9-
1. **Write your rule as a [user-defined rule](../rules/user_defined_rules/getting_started.md)**. In terms of code, Contrib rules are identical to
9+
1. **Write your rule as a [user-defined rule](../rules/user_defined_rules/index.md)**. In terms of code, Contrib rules are identical to
1010
user-defined rules, they just happen to have their code sit within the gitlint codebase itself.
1111
2. **Add your user-defined rule to gitlint**. You should put your file(s) in the [gitlint/contrib/rules](https://github.com/jorisroovers/gitlint/tree/main/gitlint-core/gitlint/contrib/rules) directory.
1212
3. **Write unit tests**. The gitlint codebase contains [Contrib rule test files you can copy and modify](https://github.com/jorisroovers/gitlint/tree/main/gitlint-core/gitlint/tests/contrib/rules).

Diff for: docs/demos/scenario.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ gitlint
6868

6969
gitlint --ignore title-trailing-punctuation
7070

71-
# For more info, visit: http://jorisroovers.github.io/gitlint
71+
# For more info, visit: https://jorisroovers.github.io/gitlint
7272

7373
exit
7474

Diff for: docs/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ a [CI pipeline](ci.md).
3434
- **Commit message hook**: [Auto-trigger validations against new commit message right when you're committing](commit_hooks.md). Also [works with pre-commit](commit_hooks.md#pre-commit).
3535
- **Perfect for CI**: Gitlint is designed to work [with your own scripts or CI system](ci.md).
3636
- **Community contributed rules**: Conventions that are common but not universal [can be selectively enabled](rules/contrib_rules.md).
37-
- **User-defined rules:** Want to do more then what gitlint offers out of the box? Write your own [user defined rules](rules/user_defined_rules/getting_started.md).
37+
- **User-defined rules:** Want to do more then what gitlint offers out of the box? Write your own [user defined rules](rules/user_defined_rules/index.md).
3838
- **Sane defaults:** Many of gitlint's validations are based on
3939
[well-known](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html),
4040
[community](https://addamhardy.com/2013-06-05-good-commit-messages-and-enforcing-them-with-git-hooks),

Diff for: docs/javascript/extra.js

+7-3
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,15 @@ document.addEventListener("DOMContentLoaded", function () {
33
new Termynal(termynalEl);
44
});
55

6-
// Redirect /gitlint/configuration/#regex-style-search to /gitlint/configuration/general_options/#regex-style-search
6+
// Redirect /gitlint/configuration/#<option> to /gitlint/configuration/general_options/#<option>
77
// This is to support old links that are in gitlint's CLI Output
88
// If the trailing slash is missing from /gitlint/configuration, mkdocs will redirect to the trailing slash version,
99
// and then this code will redirect to the correct page
10-
if (window.location.pathname == "/gitlint/configuration/" && window.location.hash === "#regex-style-search") {
11-
window.location.href = "/gitlint/configuration/general_options/#regex-style-search";
10+
if (window.location.pathname == "/gitlint/configuration/") {
11+
if (window.location.hash === "#regex-style-search") {
12+
window.location.href = "/gitlint/configuration/general_options/#regex-style-search";
13+
} else if (window.location.hash === "#staged") {
14+
window.location.href = "/gitlint/configuration/general_options/#staged";
15+
}
1216
}
1317
});

Diff for: docs/rules/contrib_rules.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Contrib rules are community-**contrib**uted rules that are disabled by default,
66

77
Contrib rules are meant to augment default gitlint behavior by providing users with rules for common use-cases without
88
forcing these rules on all gitlint users. This also means that users don't have to
9-
re-implement these commonly used rules themselves as [user-defined](user_defined_rules/getting_started.md) rules.
9+
re-implement these commonly used rules themselves as [user-defined](user_defined_rules/index.md) rules.
1010

1111
Example:
1212

Diff for: docs/rules/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,5 @@ Gitlint has different types of rules:
66

77
- **[Built-in rules](builtin_rules.md)**: the rules that come with gitlint and are enabled by default.
88
- **[Community **contrib**uted rules](contrib_rules.md)**: disabled by default, but can be enabled through configuration.
9-
- **[User-defined rule](user_defined_rules/getting_started.md)**: your own rules written in a few lines of python.
9+
- **[User-defined rule](user_defined_rules/index.md)**: your own rules written in a few lines of python.
1010
- **[Named rules](named_rules.md)**: multiple instances of rules, identified by unique names of your choosing

Diff for: docs/rules/named_rules.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -76,5 +76,5 @@ Named rules are further treated identical to all other rules in gitlint:
7676
GITLINT_IGNORE="T5:more-words,title-must-not-contain-word:extra-words" gitlint
7777
```
7878

79-
- You can use them to instantiate multiple of the same [user-defined rule](user_defined_rules/getting_started.md)
79+
- You can use them to instantiate multiple of the same [user-defined rule](user_defined_rules/index.md)
8080
- You can configure them using [any of the ways you can configure regular gitlint rules](../configuration/index.md)

Diff for: examples/gitlint

+2-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
# Rules and sections can be referenced by their full name or by id. For example
77
# section "[body-max-line-length]" could be written as "[B1]". Full section names are
88
# used in here for clarity.
9-
# Rule reference documentation: http://jorisroovers.github.io/gitlint/rules/
9+
# Rule reference documentation: https://jorisroovers.github.io/gitlint/rules/
1010
#
1111
# Note that this file is not exhaustive, it's just an example
1212
# Use 'gitlint generate-config' to generate a config file with all possible options
@@ -20,7 +20,7 @@ ignore-merge-commits=true
2020
debug = true
2121

2222
# Set the extra-path where gitlint will search for user defined rules
23-
# See http://jorisroovers.github.io/gitlint/user_defined_rules for details
23+
# See https://jorisroovers.github.io/gitlint/user_defined_rules for details
2424
# extra-path=examples/
2525

2626
[title-max-length]

Diff for: examples/my_commit_rules.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
from gitlint.rules import CommitRule, RuleViolation
33

44
"""
5-
Full details on user-defined rules: https://jorisroovers.com/gitlint/user_defined_rules
5+
Full details on user-defined rules: https://jorisroovers.github.io/gitlint/rules/user_defined_rules
66
77
The classes below are examples of user-defined CommitRules. Commit rules are gitlint rules that
88
act on the entire commit at once. Once the rules are discovered, gitlint will automatically take care of applying them

Diff for: examples/my_configuration_rules.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44

55
"""
6-
Full details on user-defined rules: https://jorisroovers.com/gitlint/user_defined_rules
6+
Full details on user-defined rules: https://jorisroovers.github.io/gitlint/user_defined_rules
77
88
The ReleaseConfigurationRule class below is an example of a user-defined ConfigurationRule. Configuration rules are
99
gitlint rules that are applied once per commit and BEFORE any other rules are run. Configuration Rules are meant to

Diff for: examples/my_line_rules.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
from gitlint.rules import CommitMessageTitle, LineRule, RuleViolation
33

44
"""
5-
Full details on user-defined rules: https://jorisroovers.com/gitlint/user_defined_rules
5+
Full details on user-defined rules: https://jorisroovers.github.io/gitlint/user_defined_rules
66
77
The SpecialChars class below is an example of a user-defined LineRule. Line rules are gitlint rules that only act on a
88
single line at once. Once the rule is discovered, gitlint will automatically take care of applying this rule

Diff for: gitlint-core/README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Gitlint-core
22

3-
# gitlint: [jorisroovers.github.io/gitlint](http://jorisroovers.github.io/gitlint/) #
3+
# gitlint: [jorisroovers.github.io/gitlint](https://jorisroovers.github.io/gitlint/) #
44

55
[![Tests](https://github.com/jorisroovers/gitlint/workflows/Tests%20and%20Checks/badge.svg)](https://github.com/jorisroovers/gitlint/actions?query=workflow%3A%22Tests+and+Checks%22)
66
[![Coverage Status](https://coveralls.io/repos/github/jorisroovers/gitlint/badge.svg?branch=fix-coveralls)](https://coveralls.io/github/jorisroovers/gitlint?branch=fix-coveralls)
@@ -9,9 +9,9 @@
99

1010
Git commit message linter written in python, checks your commit messages for style.
1111

12-
**See [jorisroovers.github.io/gitlint](http://jorisroovers.github.io/gitlint/) for full documentation.**
12+
**See [jorisroovers.github.io/gitlint](https://jorisroovers.github.io/gitlint/) for full documentation.**
1313

14-
<a href="http://jorisroovers.github.io/gitlint/" target="_blank">
14+
<a href="https://jorisroovers.github.io/gitlint/" target="_blank">
1515
<img src="https://raw.githubusercontent.com/jorisroovers/gitlint/main/docs/images/readme-gitlint.png" />
1616
</a>
1717

@@ -20,7 +20,7 @@ All contributions are welcome and very much appreciated!
2020

2121
**I'm [looking for contributors](https://github.com/jorisroovers/gitlint/issues/134) that are interested in taking a more active co-maintainer role as it's becoming increasingly difficult for me to find time to maintain gitlint. Please leave a comment in [#134](https://github.com/jorisroovers/gitlint/issues/134) if you're interested!**
2222

23-
See [jorisroovers.github.io/gitlint/contributing](http://jorisroovers.github.io/gitlint/contributing) for details on
23+
See [jorisroovers.github.io/gitlint/contributing](https://jorisroovers.github.io/gitlint/contributing) for details on
2424
how to get started - it's easy!
2525

2626
We maintain a [loose project plan on Github Projects](https://github.com/users/jorisroovers/projects/1/views/1).

Diff for: gitlint-core/gitlint/cli.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -295,7 +295,7 @@ def cli(
295295
):
296296
""" Git lint tool, checks your git commit messages for styling issues
297297
298-
Documentation: http://jorisroovers.github.io/gitlint
298+
Documentation: https://jorisroovers.github.io/gitlint
299299
"""
300300
try:
301301
if debug:

Diff for: gitlint-core/gitlint/deprecation.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ def get_regex_method(cls, rule, regex_option):
2828
"'search' (match anywhere) semantics. "
2929
f"Please review your {rule.name}.regex option accordingly. "
3030
"To remove this warning, set general.regex-style-search=True. "
31-
"More details: https://jorisroovers.github.io/gitlint/configuration/#regex-style-search"
31+
"More details: https://jorisroovers.github.io/gitlint/configuration/general_options/#regex-style-search"
3232
)
3333

3434
# Only log warnings once

Diff for: gitlint-core/gitlint/files/gitlint

+4-3
Original file line numberDiff line numberDiff line change
@@ -35,19 +35,20 @@
3535
# fail-without-commits=true
3636

3737
# Whether to use Python `search` instead of `match` semantics in rules that use
38-
# regexes. Context: https://github.com/jorisroovers/gitlint/issues/254
38+
# regexes.
39+
# Context: https://jorisroovers.github.io/gitlint/configuration/general_options/#regex-style-search
3940
# Disabled by default, but will be enabled by default in the future.
4041
# regex-style-search=true
4142

4243
# Enable debug mode (prints more output). Disabled by default.
4344
# debug=true
4445

4546
# Enable community contributed rules
46-
# See http://jorisroovers.github.io/gitlint/contrib_rules for details
47+
# See https://jorisroovers.github.io/gitlint/contrib_rules for details
4748
# contrib=contrib-title-conventional-commits,CC1
4849

4950
# Set the extra-path where gitlint will search for user defined rules
50-
# See http://jorisroovers.github.io/gitlint/user_defined_rules for details
51+
# See https://jorisroovers.github.io/gitlint/user_defined_rules for details
5152
# extra-path=examples/
5253

5354
# This is an example of how to configure the "title-max-length" rule and

Diff for: gitlint-core/gitlint/rules.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -471,7 +471,7 @@ def apply(self, config, commit):
471471
warning_msg = (
472472
"%s - %s: skipping - commit.author_name unknown. "
473473
"Suggested fix: Use the --staged flag (or set general.staged=True in .gitlint). "
474-
"More details: https://jorisroovers.com/gitlint/configuration/#staged"
474+
"More details: https://jorisroovers.github.io/gitlint/configuration/general_options/#staged"
475475
)
476476

477477
self.log.warning(warning_msg, self.name, self.id)

Diff for: gitlint-core/gitlint/tests/base.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
"Python regex 'match' (match beginning) to 'search' (match anywhere) semantics. "
2121
"Please review your {1}.regex option accordingly. "
2222
"To remove this warning, set general.regex-style-search=True. More details: "
23-
"https://jorisroovers.github.io/gitlint/configuration/#regex-style-search"
23+
"https://jorisroovers.github.io/gitlint/configuration/general_options/#regex-style-search"
2424
)
2525

2626

Diff for: gitlint-core/gitlint/tests/rules/test_configuration_rules.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ def test_ignore_by_author_name(self):
101101
expected_log_messages = [
102102
"WARNING: gitlint.rules ignore-by-author-name - I4: skipping - commit.author_name unknown. "
103103
"Suggested fix: Use the --staged flag (or set general.staged=True in .gitlint). "
104-
"More details: https://jorisroovers.com/gitlint/configuration/#staged"
104+
"More details: https://jorisroovers.github.io/gitlint/configuration/general_options/#staged"
105105
]
106106
self.assert_logged(expected_log_messages)
107107

Diff for: mkdocs.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
site_name: Gitlint
22
site_description: Linting for your git commit messages
3-
site_url: http://jorisroovers.github.io/gitlint/
3+
site_url: https://jorisroovers.github.io/gitlint/
44
repo_url: https://github.com/jorisroovers/gitlint
55
repo_name: jorisroovers/gitlint
6-
# strict: true
6+
strict: true
77
edit_uri: edit/main/docs
88
markdown_extensions:
99
- admonition
@@ -37,7 +37,7 @@ plugins:
3737
redirect_maps:
3838
# URLs present in the generated .gitlint file
3939
contrib_rules.md : rules/contrib_rules.md
40-
user_defined_rules.md : rules/contrib_rules.md
40+
user_defined_rules.md : rules/user_defined_rules/index.md
4141

4242
theme:
4343
name: material
@@ -117,7 +117,7 @@ nav:
117117
- Contrib Rules: rules/contrib_rules.md
118118
- Named Rules: rules/named_rules.md
119119
- User Defined Rules:
120-
- Getting Started: rules/user_defined_rules/getting_started.md
120+
- Getting Started: rules/user_defined_rules/index.md
121121
- Line and Commit Rules: rules/user_defined_rules/line_and_commit_rules.md
122122
- Configuration Rules: rules/user_defined_rules/configuration_rules.md
123123
- Rule Violations: rules/user_defined_rules/violations.md

0 commit comments

Comments
 (0)