darabos commited on
Commit
c069d9e
·
1 Parent(s): a6f4e88

Move dev documentation to contributing.md.

Browse files
Files changed (3) hide show
  1. README.md +6 -46
  2. docs/contributing.md +54 -0
  3. mkdocs.yml +3 -2
README.md CHANGED
@@ -15,57 +15,17 @@ The two tools offer similar functionality, but are not compatible.
15
  This version runs on GPU clusters instead of Hadoop clusters.
16
  It targets CUDA instead of Apache Spark. It is much more extensible.
17
 
18
- Check out our [**online demo**](https://lynx-analytics-lynxkite.hf.space/).
19
-
20
- ## Structure
21
-
22
- - `lynxkite-core`: Core types and utilities. Depend on this lightweight package if you are writing LynxKite plugins.
23
- - `lynxkite-app`: The LynxKite web application. Install some plugins then run this to use LynxKite.
24
- - `lynxkite-graph-analytics`: Graph analytics plugin. The classical LynxKite experience!
25
- - `lynxkite-pillow`: A simple example plugin.
26
- - `docs`: User-facing documentation. It's shared between all packages.
27
-
28
- ## Development
29
-
30
- Install everything like this:
31
-
32
- ```bash
33
- uv venv
34
- source .venv/bin/activate
35
- uvx pre-commit install
36
- # The [dev] tag is only needed if you intend on running tests
37
- uv pip install -e lynxkite-core/[dev] -e lynxkite-app/[dev] -e lynxkite-graph-analytics/[dev] -e lynxkite-pillow-example/
38
- ```
39
-
40
- This also builds the frontend, hopefully very quickly. To run it:
41
-
42
- ```bash
43
- cd examples && lynxkite
44
- ```
45
-
46
- If you also want to make changes to the frontend with hot reloading:
47
-
48
- ```bash
49
- cd lynxkite-app/web
50
- npm run dev
51
- ```
52
-
53
- ## Executing tests
54
-
55
- Run all tests with a single command, or look inside to see how to run them individually:
56
 
57
  ```bash
58
- ./test.sh
59
  ```
60
 
61
- ## Documentation
62
-
63
- To work on the documentation:
64
 
65
- ```bash
66
- uv pip install mkdocs-material mkdocstrings[python]
67
- mkdocs serve
68
- ```
69
 
70
  ## License
71
 
 
15
  This version runs on GPU clusters instead of Hadoop clusters.
16
  It targets CUDA instead of Apache Spark. It is much more extensible.
17
 
18
+ ## Installation
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19
 
20
  ```bash
21
+ pip install lynxkite lynxkite-graph-analytics
22
  ```
23
 
24
+ ## Getting started
 
 
25
 
26
+ - [Online demo](https://lynx-analytics-lynxkite.hf.space/)
27
+ - [Quickstart](https://lynxkite.github.io/lynxkite-2000/guides/quickstart/)
28
+ - [Contributing](https://lynxkite.github.io/lynxkite-2000/contributing/)
 
29
 
30
  ## License
31
 
docs/contributing.md ADDED
@@ -0,0 +1,54 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Contributing
2
+
3
+ The LynxKite 2000:MM repository lives at [https://github.com/lynxkite/lynxkite-2000](https://github.com/lynxkite/lynxkite-2000).
4
+ Bug reports, feature requests, and pull requests are welcome!
5
+
6
+ ## Project structure
7
+
8
+ - `lynxkite-core`: Core types and utilities. Depend on this lightweight package if you are writing LynxKite plugins.
9
+ - `lynxkite-app`: The LynxKite web application. Install some plugins then run this to use LynxKite.
10
+ - `lynxkite-graph-analytics`: Graph analytics plugin. The classical LynxKite experience!
11
+ - `lynxkite-pillow`: A simple example plugin.
12
+ - `docs`: User-facing documentation. It's shared between all packages.
13
+
14
+ ## Development setup
15
+
16
+ Install everything like this:
17
+
18
+ ```bash
19
+ uv venv
20
+ source .venv/bin/activate
21
+ uvx pre-commit install
22
+ uv pip install -e 'lynxkite-core/[dev]' -e 'lynxkite-app/[dev]' -e 'lynxkite-graph-analytics/[dev]' -e lynxkite-pillow-example/
23
+ ```
24
+
25
+ This also builds the frontend, hopefully very quickly. To run it:
26
+
27
+ ```bash
28
+ cd examples
29
+ lynxkite
30
+ ```
31
+
32
+ If you also want to make changes to the frontend with hot reloading:
33
+
34
+ ```bash
35
+ cd lynxkite-app/web
36
+ npm run dev
37
+ ```
38
+
39
+ ## Executing tests
40
+
41
+ Run all tests with a single command, or look inside to see how to run them individually:
42
+
43
+ ```bash
44
+ ./test.sh
45
+ ```
46
+
47
+ ## Documentation
48
+
49
+ To work on the documentation:
50
+
51
+ ```bash
52
+ uv pip install mkdocs-material mkdocstrings[python]
53
+ mkdocs serve
54
+ ```
mkdocs.yml CHANGED
@@ -4,9 +4,10 @@ repo_name: lynxkite/lynxkite-2000
4
  watch: [mkdocs.yml, README.md, lynxkite-core, lynxkite-graph-analytics, lynxkite-app]
5
 
6
  nav:
7
- - Home:
8
  - Overview: index.md
9
- - License: license.md
 
10
  - Guides:
11
  - guides/quickstart.md
12
  - guides/analytics.md
 
4
  watch: [mkdocs.yml, README.md, lynxkite-core, lynxkite-graph-analytics, lynxkite-app]
5
 
6
  nav:
7
+ - About LynxKite:
8
  - Overview: index.md
9
+ - contributing.md
10
+ - license.md
11
  - Guides:
12
  - guides/quickstart.md
13
  - guides/analytics.md