Skip to content

Commit f36776d

Browse files
Enhance GuideLLM Documentation and Setup (#21)
## Summary This pull request introduces significant enhancements to the GuideLLM project documentation and setup processes. The updates aim to provide clear guidance to contributors, improve project accessibility, and enforce markdown formatting standards. ## Changes Made - **README.md**: Added a comprehensive README with project overview, key features, installation instructions, quick start guide, and advanced settings. Updated to include badges, images, and structured documentation links for better navigation. - **Markdown Formatting**: Implemented markdown formatting checks using `mdformat` to enforce consistent documentation standards across the project. - **Pyproject.toml and Tox Configuration**: Updated configurations to include documentation quality checks, ensuring markdown files adhere to best practices. ## Test Plan - Verified that all markdown files comply with the formatting standards set by `mdformat`. - Conducted manual testing to ensure links and images render correctly in the README and other markdown documents. - Ran unit tests to confirm that existing functionality remains unaffected by documentation updates. --------- Co-authored-by: Mark Kurtz <mark.kurtz@neuralmagic.com>
1 parent 7f39986 commit f36776d

23 files changed

+196
-102
lines changed

.mdformat.toml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
wrap = "no"
2+
number = true
3+
end_of_line = "lf"

CODE_OF_CONDUCT.md

Lines changed: 20 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -1,92 +1,47 @@
1-
<!--
2-
Copyright (c) 2021 - present / Neuralmagic, Inc. All Rights Reserved.
3-
4-
Licensed under the Apache License, Version 2.0 (the "License");
5-
you may not use this file except in compliance with the License.
6-
You may obtain a copy of the License at
7-
8-
http://www.apache.org/licenses/LICENSE-2.0
9-
10-
Unless required by applicable law or agreed to in writing,
11-
software distributed under the License is distributed on an "AS IS" BASIS,
12-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13-
See the License for the specific language governing permissions and
14-
limitations under the License.
15-
-->
16-
171
# Community Code of Conduct
182

193
## Our Pledge
204

21-
In the interest of fostering an open and welcoming environment, we as
22-
contributors and maintainers pledge to make participation in our project and
23-
our community a harassment-free experience for everyone, regardless of age, body
24-
size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression,
25-
level of experience, education, socio-economic status, nationality, personal
26-
appearance, race, religion, or sexual identity and orientation.
5+
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
276

287
## Our Standards
298

30-
Examples of behavior that contributes to creating a positive environment
31-
include:
9+
Examples of behavior that contributes to creating a positive environment include:
3210

33-
* Using welcoming and inclusive language
34-
* Being respectful of differing viewpoints and experiences
35-
* Gracefully accepting constructive criticism
36-
* Focusing on what is best for the community
37-
* Showing empathy towards other community members
11+
- Using welcoming and inclusive language
12+
- Being respectful of differing viewpoints and experiences
13+
- Gracefully accepting constructive criticism
14+
- Focusing on what is best for the community
15+
- Showing empathy towards other community members
3816

3917
Examples of unacceptable behavior by participants include:
4018

41-
* The use of sexualized language or imagery and unwelcome sexual attention or
42-
advances
43-
* Trolling, insulting/derogatory comments, and personal or political attacks
44-
* Public or private harassment
45-
* Publishing others' private information, such as a physical or electronic
46-
address, without explicit permission
47-
* Other conduct which could reasonably be considered inappropriate in a
48-
professional setting
19+
- The use of sexualized language or imagery and unwelcome sexual attention or advances
20+
- Trolling, insulting/derogatory comments, and personal or political attacks
21+
- Public or private harassment
22+
- Publishing others' private information, such as a physical or electronic address, without explicit permission
23+
- Other conduct which could reasonably be considered inappropriate in a professional setting
4924

5025
## Our Responsibilities
5126

52-
Project maintainers are responsible for clarifying the standards of acceptable
53-
behavior and are expected to take appropriate and fair corrective action in
54-
response to any instances of unacceptable behavior.
27+
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
5528

56-
Project maintainers have the right and responsibility to remove, edit, or
57-
reject comments, commits, code, wiki edits, issues, and other contributions
58-
that are not aligned to this Code of Conduct, or to ban temporarily or
59-
permanently any contributor for other behaviors that they deem inappropriate,
60-
threatening, offensive, or harmful.
29+
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
6130

6231
## Scope
6332

64-
This Code of Conduct applies within all project spaces, and it also applies when
65-
an individual is representing the project or its community in public spaces.
66-
Examples of representing a project or community include using an official
67-
project e-mail address, posting via an official social media account, or acting
68-
as an appointed representative at an online or offline event. Representation of
69-
a project may be further defined and clarified by project maintainers.
33+
This Code of Conduct applies within all project spaces, and it also applies when an individual is representing the project or its community in public spaces. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
7034

7135
## Enforcement
7236

73-
Instances of abusive, harassing, or otherwise unacceptable behavior may be
74-
reported by contacting the project team using the [Neural Magic Contact Us Form](https://neuralmagic.com/contact). All
75-
complaints will be reviewed and investigated and will result in a response that
76-
is deemed necessary and appropriate to the circumstances. The project team is
77-
obligated to maintain confidentiality with regard to the reporter of an incident.
78-
Further details of specific enforcement policies may be posted separately.
37+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team using the [Neural Magic Contact Us Form](https://neuralmagic.com/contact). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
7938

80-
Project maintainers who do not follow or enforce the Code of Conduct in good
81-
faith may face temporary or permanent repercussions as determined by other
82-
members of the project's leadership.
39+
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
8340

8441
## Attribution
8542

86-
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
87-
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
43+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
8844

89-
[homepage]: https://www.contributor-covenant.org
45+
For answers to common questions about this code of conduct, see https://www.contributor-covenant.org/faq
9046

91-
For answers to common questions about this code of conduct, see
92-
https://www.contributor-covenant.org/faq
47+
[homepage]: https://www.contributor-covenant.org

CONTRIBUTING.md

Lines changed: 0 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,3 @@
1-
<!--
2-
Copyright (c) 2021 - present / Neuralmagic, Inc. All Rights Reserved.
3-
4-
Licensed under the Apache License, Version 2.0 (the "License");
5-
you may not use this file except in compliance with the License.
6-
You may obtain a copy of the License at
7-
8-
http://www.apache.org/licenses/LICENSE-2.0
9-
10-
Unless required by applicable law or agreed to in writing,
11-
software distributed under the License is distributed on an "AS IS" BASIS,
12-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13-
See the License for the specific language governing permissions and
14-
limitations under the License.
15-
-->
16-
171
# Contributing to GuideLLM
182

193
If you’re reading this, hopefully we have piqued your interest to take the next step. Join us and help make GuideLLM even better! As a contributor, here are some community guidelines we would like you to follow:

DEVELOPING.md

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22

33
## Introduction
44

5-
Welcome to the developer documentation for `guidellm`, a guidance platform for evaluating large language model deployments.
6-
This document aims to provide developers with all the necessary information to contribute to the project effectively.
5+
Welcome to the developer documentation for `guidellm`, a guidance platform for evaluating large language model deployments. This document aims to provide developers with all the necessary information to contribute to the project effectively.
76

87
## Getting Started
98

@@ -25,6 +24,7 @@ Before you begin, ensure you have the following installed:
2524
```
2625

2726
2. Install the required dependencies:
27+
2828
```bash
2929
pip install -e .[dev]
3030
```
@@ -60,6 +60,7 @@ To set up your development environment, follow these steps:
6060
```
6161

6262
2. Ensure all dependencies are installed:
63+
6364
```bash
6465
pip install -e .[dev]
6566
```
@@ -120,35 +121,31 @@ To run all tests:
120121
tox
121122
```
122123

123-
Additionally, all tests are marked with smoke, sanity, or regression tags for better organization.
124-
To run tests with a specific tag, use the `-m` flag:
124+
Additionally, all tests are marked with smoke, sanity, or regression tags for better organization. To run tests with a specific tag, use the `-m` flag:
125125

126126
```bash
127127
tox -- -m "smoke or sanity"
128128
```
129129

130130
### Running Unit Tests
131131

132-
The unit tests are located in the `tests/unit` directory.
133-
To run the unit tests, use the following command:
132+
The unit tests are located in the `tests/unit` directory. To run the unit tests, use the following command:
134133

135134
```bash
136135
tox -e test-unit
137136
```
138137

139138
### Running Integration Tests
140139

141-
The integration tests are located in the `tests/integration` directory.
142-
To run the integration tests, use the following command:
140+
The integration tests are located in the `tests/integration` directory. To run the integration tests, use the following command:
143141

144142
```bash
145143
tox -e test-integration
146144
```
147145

148146
### Running End-to-End Tests
149147

150-
The end-to-end tests are located in the `tests/e2e` directory.
151-
To run the end-to-end tests, use the following command:
148+
The end-to-end tests are located in the `tests/e2e` directory. To run the end-to-end tests, use the following command:
152149

153150
```bash
154151
tox -e test-e2e
@@ -198,9 +195,7 @@ tox -e clean
198195

199196
## Continuous Integration/Continuous Deployment (CI/CD)
200197

201-
Our CI/CD pipeline is configured using GitHub Actions.
202-
The configuration files are located in the .github/workflows/ directory.
203-
You can run the CI/CD pipeline locally using act or similar tools.
198+
Our CI/CD pipeline is configured using GitHub Actions. The configuration files are located in the .github/workflows/ directory. You can run the CI/CD pipeline locally using act or similar tools.
204199

205200
## Contributing
206201

0 commit comments

Comments
 (0)