45 lines
1.1 KiB
Markdown
Raw Normal View History

docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
# Sudoku Generator
feat: add initial project scaffolding with Makefile, C sources, web UI, and documentation Add Makefile with build targets for sudoku solver, generator, and coverage reporting. Include NOTES.md explaining sudoku difficulty factors and solving techniques. Add README.md with puzzle examples and generator output. Implement app.js with Grid and Grid2 classes for rendering puzzle data in the browser. Add box.c with functions for box indexing, grid-to-array conversion, and box value extraction. Include footer.h with terminal size detection, cursor positioning, and footer display utilities. Add index.html with CSS grid layout and script loading for the web interface. Include rlib.h as a large utility header library.
2025-01-10 22:53:10 +01:00
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
## Project description
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
This project is just a collection of research regarding the generation of sudoku's.
It's not a production project.
feat: add initial project scaffolding with Makefile, C sources, web UI, and documentation Add Makefile with build targets for sudoku solver, generator, and coverage reporting. Include NOTES.md explaining sudoku difficulty factors and solving techniques. Add README.md with puzzle examples and generator output. Implement app.js with Grid and Grid2 classes for rendering puzzle data in the browser. Add box.c with functions for box indexing, grid-to-array conversion, and box value extraction. Include footer.h with terminal size detection, cursor positioning, and footer display utilities. Add index.html with CSS grid layout and script loading for the web interface. Include rlib.h as a large utility header library.
2025-01-10 22:53:10 +01:00
docs: add valid sudoku count and clarify project focus on hardest puzzles in readme The readme now includes the exact number of valid Sudoku puzzles (6.67 × 10²¹) and explicitly states the project's focus on generating and solving the hardest possible sudokus, replacing the vague reference to backtracking algorithms.
2025-01-10 23:42:10 +01:00
The number of valid Sudoku puzzles has been calculated to be 6,670,903,752,021,072,936,960 (approximately 6.67 × 10²¹).
The main focus of this project is to generate and solve the hardest possible sudoku's.
feat: add initial project scaffolding with Makefile, C sources, web UI, and documentation Add Makefile with build targets for sudoku solver, generator, and coverage reporting. Include NOTES.md explaining sudoku difficulty factors and solving techniques. Add README.md with puzzle examples and generator output. Implement app.js with Grid and Grid2 classes for rendering puzzle data in the browser. Add box.c with functions for box indexing, grid-to-array conversion, and box value extraction. Include footer.h with terminal size detection, cursor positioning, and footer display utilities. Add index.html with CSS grid layout and script loading for the web interface. Include rlib.h as a large utility header library.
2025-01-10 22:53:10 +01:00
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
## Applications
feat: add initial project scaffolding with Makefile, C sources, web UI, and documentation Add Makefile with build targets for sudoku solver, generator, and coverage reporting. Include NOTES.md explaining sudoku difficulty factors and solving techniques. Add README.md with puzzle examples and generator output. Implement app.js with Grid and Grid2 classes for rendering puzzle data in the browser. Add box.c with functions for box indexing, grid-to-array conversion, and box value extraction. Include footer.h with terminal size detection, cursor positioning, and footer display utilities. Add index.html with CSS grid layout and script loading for the web interface. Include rlib.h as a large utility header library.
2025-01-10 22:53:10 +01:00
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
### Sudoku Generator
Just execute application and it will generate a sudoku for you with certain complexity.
### Sudoku Solvder
Give sudoku puzzle as input and it will solve it for you
### Sudoku Web
Run this server and it will run multiple sudoku generators and keeps track of many statistics while generating them.
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
## Screenshots
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
Will come when I figured out how to use this project again.
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
### First version
docs: add five sudoku screenshots to README and fix rlib include path in web.c
2025-01-10 23:14:36 +01:00
![screenshot](images/sudoku1.png)
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
### Second version
docs: add five sudoku screenshots to README and fix rlib include path in web.c
2025-01-10 23:14:36 +01:00
![screenshot](images/sudoku2.png)
docs: add sudoku screenshots and update readme with revised usage instructions
2025-01-10 23:16:43 +01:00
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
### Sudoku solver
docs: add five sudoku screenshots to README and fix rlib include path in web.c
2025-01-10 23:14:36 +01:00
![screenshot](images/sudoku4.png)
docs: add sudoku screenshots and update readme with revised usage instructions
2025-01-10 23:16:43 +01:00
docs: add project overview section and fix heading levels in readme Add a "Project description" section to clarify the purpose of the sudoku generator research project, and correct inconsistent markdown heading levels (changing from `####` to `##` or `###`) for screenshots and solver subsections to improve document structure and readability.
2025-01-10 23:43:21 +01:00
### Last version including the web interface reachable on 9999
docs: add sudoku screenshots and update readme with revised usage instructions
2025-01-10 23:16:43 +01:00
![screenshot](images/sudoku3.png)
docs: add five sudoku screenshots to README and fix rlib include path in web.c
2025-01-10 23:14:36 +01:00
![screenshot](images/sudoku5.png)
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
docs: add sudoku screenshots and update readme with revised usage instructions
2025-01-10 23:16:43 +01:00
docs: replace full readme with project description and usage instructions for sudoku generator, solver, and web apps
2025-01-10 22:59:49 +01:00
## How to use
docs: add sudoku screenshots and update readme with revised usage instructions
2025-01-10 23:16:43 +01:00
Will come soon, the Makefile is a work in progress. The whole project is.
feat: add initial project scaffolding with Makefile, C sources, web UI, and documentation Add Makefile with build targets for sudoku solver, generator, and coverage reporting. Include NOTES.md explaining sudoku difficulty factors and solving techniques. Add README.md with puzzle examples and generator output. Implement app.js with Grid and Grid2 classes for rendering puzzle data in the browser. Add box.c with functions for box indexing, grid-to-array conversion, and box value extraction. Include footer.h with terminal size detection, cursor positioning, and footer display utilities. Add index.html with CSS grid layout and script loading for the web interface. Include rlib.h as a large utility header library.
2025-01-10 22:53:10 +01:00
Reference in New Issue Copy Permalink