Skip to content

Commit bbdc7a8

Browse files
committed
update index
1 parent f4d6b65 commit bbdc7a8

8 files changed

Lines changed: 1003 additions & 10 deletions

File tree

book.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ src = "docs/src"
99
default-theme = "navy"
1010
git-repository-url = "https://github.com/CodingThrust/problem-reductions"
1111
edit-url-template = "https://github.com/CodingThrust/problem-reductions/edit/main/{path}"
12-
additional-css = []
12+
additional-css = ["docs/src/static/theme-images.css"]
1313
additional-js = []
1414
no-section-label = false
1515

docs/paper/reduction_graph.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -496,7 +496,7 @@
496496
"overhead": [
497497
{
498498
"field": "num_vars",
499-
"formula": "num_vars"
499+
"formula": "num_vars + num_clauses"
500500
}
501501
],
502502
"doc_path": "rules/ksatisfiability_qubo/index.html"

docs/src/introduction.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ A Rust library for reducing NP-hard problems.
44

55
## Overview
66

7-
**problemreductions** provides implementations of various computational hard problems and reduction rules between them. It is designed for algorithm research, education, and quantum optimization studies.
7+
**problemreductions** provides implementations of various computational hard problems and reduction rules between them. It is designed for algorithm research, education, and industry applications.
88

99
For theoretical background and correctness proofs, see the [PDF manual](https://codingthrust.github.io/problem-reductions/reductions.pdf).
1010

@@ -366,15 +366,26 @@ The library supports four graph topologies:
366366

367367
## Our vision
368368

369-
In the past, computational complexity theorists focus mostly on the theory part, left the tedious implementation to developers. This `algorithm -> paper` mode causes many repeated efforts in algorithm implementation. Due to the lack of infrastructures, many fundamental issues can not be answered clearly, such as
370-
- What is the fastest algorithm for solving a problem?
371-
- Given an efficient solver, what are the potential high impact problems it can be used for?
369+
Historically, computational complexity theorists have focused on the theory, leaving the tedious implementation work to developers. This `algorithm paper` pipeline causes much duplicated effort in algorithm implementation. Without the right infrastructure, fundamental questions remain difficult to answer:
370+
- What is the fastest known algorithm for solving a given problem?
371+
- Given an efficient solver, which high-impact problems can it reach via reductions?
372372

373-
Imagine, if every problem in this world is connected as a directed reduction graph, such that given any pairs of problems, we can easily find the most efficient reduction path between them. We can create a high speed rail-way between any two problems. We will no longer have repeated efforts in solving problems that are essentially the "same". However, developing this software infrastructure is not easy.
373+
Imagine every computational problem in the world connected in a directed reduction graph, so that for any pair of problems we can find the most efficient reduction path between thema high-speed railway linking any two problems. We would no longer duplicate effort solving problems that are essentially the "same." Building this infrastructure, however, is not easy.
374374

375-
What if AI take over the implementation part, and complete the `algoirthm -> paper -> software` pipeline? Theorists can still focus on the theory part, and AI will do the heavy lifting. How is it possible? Can we trust AI's implementation? Our answer is, yes. Not only due to the fast evolving large language models brings new power, but also due to the fact that almost all reductions can be verified by running round-trip tests (`source -> target -> solution to target -> solution to source` must equal to `source -> solution to source`). We can easily verify the correctness of the reduction by checking round-trip reduction examples.
375+
What if AI could take over the implementation step, completing an `algorithm → paper software` pipeline? Theorists would still focus on theory while AI does the heavy lifting. Can we trust AI-generated implementations? We believe so — not only because large language models are rapidly improving, but also because nearly all reductions can be verified with round-trip tests: `source target solution to target solution to source` must equal `source solution to source`. Correctness is checked automatically by running these round-trip examples.
376376

377-
Our vision is to automate this test-driven development pipeline, and enable general public to contribute. Our software will be open sourced, forever, for at any physical location in the universe to every human being and AI agent.
377+
<div class="theme-light-only">
378+
379+
![](static/workflow-loop.svg)
380+
381+
</div>
382+
<div class="theme-dark-only">
383+
384+
![](static/workflow-loop-dark.svg)
385+
386+
</div>
387+
388+
Our vision is to automate this test-driven development pipeline and enable the general public to contribute. This software will be open source, forever, available at any physical location in the universe to every human being and AI agent.
378389

379390
## License
380391

docs/src/reductions/reduction_graph.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -496,7 +496,7 @@
496496
"overhead": [
497497
{
498498
"field": "num_vars",
499-
"formula": "num_vars"
499+
"formula": "num_vars + num_clauses"
500500
}
501501
],
502502
"doc_path": "rules/ksatisfiability_qubo/index.html"

docs/src/static/theme-images.css

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
/* Switch between light/dark diagram variants based on mdBook theme */
2+
3+
/* Hide dark images by default (light theme) */
4+
.theme-dark-only {
5+
display: none;
6+
}
7+
8+
/* Dark themes: hide light, show dark */
9+
.coal .theme-light-only,
10+
.navy .theme-light-only,
11+
.ayu .theme-light-only {
12+
display: none;
13+
}
14+
15+
.coal .theme-dark-only,
16+
.navy .theme-dark-only,
17+
.ayu .theme-dark-only {
18+
display: initial;
19+
}

0 commit comments

Comments
 (0)