Skip to content

Commit a9d6a04

Browse files
Update README.md
1 parent 38d2b37 commit a9d6a04

File tree

1 file changed

+42
-21
lines changed

1 file changed

+42
-21
lines changed

README.md

Lines changed: 42 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,77 @@
11
# Code Sharing Application
22

3-
A Django-based web application designed for developers to share, organize, and manage code snippets efficiently.
3+
A Django-based web application that enables developers to share, organize, and manage code snippets efficiently. The platform is designed with productivity and collaboration in mind, offering robust features for storing, searching, and interacting with code examples.
44

55
## Features
66

7-
* **User Authentication**: Secure login and registration system.
8-
* **Code Snippet Management**: Users can create, edit, and delete their code snippets.
9-
* **Syntax Highlighting**: Supports multiple programming languages for better readability.
10-
* **Search Functionality**: Easily search through saved snippets.
11-
* **Responsive Design**: Accessible on both desktop and mobile devices.
7+
- **User Authentication:** Secure registration and login system for managing personal code snippets.
8+
- **Code Snippet Management:** Create, edit, and delete code snippets with metadata such as language, tags, and descriptions.
9+
- **Syntax Highlighting:** Supports multiple programming languages with syntax highlighting for enhanced readability.
10+
- **Search and Filter:** Quickly search and filter snippets by title, tags, language, and author.
11+
- **Bookmarks:** Bookmark favorite snippets for easy access.
12+
- **Rating System:** Mark snippets as useful or not useful to help surface high-quality content.
13+
- **Responsive Design:** Fully accessible on desktop and mobile devices.
14+
- **Author and Language Browsing:** Browse snippets by language or author for topical exploration.
1215

1316
## Technologies Used
1417

15-
* **Backend**: Django (Python)
16-
* **Frontend**: HTML, CSS, JavaScript
17-
* **Database**: SQLite (default)
18+
- **Backend:** Django (Python)
19+
- **Frontend:** HTML, CSS (Bootstrap), JavaScript
20+
- **Database:** SQLite (default, easily configurable to other databases)
21+
- **Syntax Highlighting:** [Pygments](https://pygments.org/)
1822

1923
## Installation
2024

21-
1. Clone the repository:
22-
25+
1. **Clone the repository:**
2326
```bash
2427
git clone https://github.com/SulemanMughal/code-sharing.git
2528
cd code-sharing
2629
```
2730

28-
2. Install dependencies:
29-
31+
2. **Install dependencies:**
3032
```bash
3133
pip install -r requirements.txt
3234
```
3335

34-
3. Apply migrations:
35-
36+
3. **Apply migrations:**
3637
```bash
3738
python manage.py migrate
3839
```
3940

40-
4. Create a superuser:
41-
41+
4. **Create a superuser:**
4242
```bash
4343
python manage.py createsuperuser
4444
```
4545

46-
5. Run the development server:
47-
46+
5. **Run the development server:**
4847
```bash
4948
python manage.py runserver
5049
```
5150

52-
6. Access the application at `http://127.0.0.1:8000/`.
51+
6. **Access the application:**
52+
Open your browser and visit [http://127.0.0.1:8000/](http://127.0.0.1:8000/).
53+
54+
## Usage
55+
56+
- Register or log in to start creating and managing your code snippets.
57+
- Use the navigation bar to view all snippets, browse by language, author, or manage your bookmarks.
58+
- Add new snippets with syntax highlighting and descriptive tags.
59+
- Bookmark and rate snippets to curate and promote useful code for the community.
5360

5461
## Contributing
5562

56-
Contributions are welcome! Please fork the repository, make your changes, and submit a pull request.
63+
Contributions are welcome! Please fork the repository, create a feature branch, make your changes, and submit a pull request.
64+
65+
1. Fork the repository
66+
2. Create your feature branch: `git checkout -b feature/YourFeature`
67+
3. Commit your changes: `git commit -am 'Add some feature'`
68+
4. Push to the branch: `git push origin feature/YourFeature`
69+
5. Open a pull request
70+
71+
## License
72+
73+
This project is licensed under the MIT License.
74+
75+
## Contact
76+
77+
For any questions or feedback, please open an issue or contact [SulemanMughal](https://github.com/SulemanMughal).

0 commit comments

Comments
 (0)