Skip to content

Commit 0e494eb

Browse files
authored
Update README.md
1 parent d774886 commit 0e494eb

File tree

1 file changed

+24
-37
lines changed

1 file changed

+24
-37
lines changed

README.md

Lines changed: 24 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,28 @@
1-
**nexus** is a *threefold documentation resource* for open research: *native*, *external* via URL pointers,
2-
and *hybrid*. Hybrid documentation is commentary generated when working through an external resource such
3-
as a tutorial. This is intended to fill context gaps, note gotchas and so on: Make the path easier to follow.
1+
[nexus published](https://robfatland.github.io/nexus), [index source](https://github.com/robfatland/nexus/blob/gh-pages/index.md)
42

53

6-
This is the [meta-narrative for nexus](https://github.com/robfatland/nexus), main branch `README.md`.
7-
<br> **nexus** source is the [`gh-pages` branch](https://github.com/robfatland/nexus/tree/gh-pages).
8-
<br> **nexus** publishes at [https://robfatland.github.io/nexus](https://robfatland.github.io/nexus).
4+
# **nexus**
95

6+
...is a *threefold documentation resource* for open research: *native*, *external* via URL pointers,
7+
and *hybrid* documentation. *Hybrid* is commentary from working an external tutorial: To fill context gaps,
8+
note gotchas and so on: Make the path easier to follow.
109

11-
# [nexus](https://robfatland.github.io/nexus/)
10+
11+
- This is [`main:README.md` for nexus](https://github.com/robfatland/nexus).
12+
- For content go to the [`gh-pages` branch](https://github.com/robfatland/nexus/tree/gh-pages).
13+
- Static site published at [https://robfatland.github.io/nexus](https://robfatland.github.io/nexus).
14+
15+
16+
## motivation
1217

1318

1419
[This repo](https://github.com/robfatland/nexus/tree/main) is motivated by frustration: With sorting out
15-
some technical detail, writing out notes, losing the notes, and coming back to the same task three months
16-
later. The process to deal with this is to build the nexus static website using github pages. Themes are
17-
all within the topic of open science practice and how to build research computing cyberinfrastructure.
20+
a technical task; then writing out notes; then losing those notes; then coming back to the task three months
21+
later; then start over. Now the idea is to build the nexus static website from github pages. Theme is
22+
open science in practice, particularly how to build research computing cyberinfrastructure.
1823

1924

20-
## Example motivating tasks
25+
## Example tasks
2126

2227

2328
- How do I manage Python environments?
@@ -29,29 +34,11 @@ all within the topic of open science practice and how to build research computin
2934
- How do I set up a cloud VM as my power workstation and use Jupyter there from my laptop?
3035

3136

32-
## nexus aspirations (the to-do list)
33-
34-
35-
- TCOTU: Understanding, building, maintaining, using Python environments
36-
- corollary: customizing `bash`, `vi` to a simple appearance
37-
- **`ssh`** tunnels from one machine to another
38-
- headless `jupyter` running on a cloud VM with a localhost laptop interface
39-
- Comparison: **`miniconda`** versus **`anaconda`**
40-
- PC-based Linux / IDE: **`Ubuntu bash`**, **`WSL-2`**, **`VSCode`**
41-
- Containerization
42-
- conda environments
43-
- cloud infrastructure building
44-
- Data systems, APIs
45-
- Building a Flask server
46-
- Cloud security
47-
- ML/AI: CNN, NLP
48-
- varieties of cloud CLI
49-
- cloud spend notification
50-
- stopping runaway cloud spend automatically
51-
- [Python's guide to publishing a software package](https://packaging.python.org/en/latest/tutorials/packaging-projects/)
52-
- Some of my other current (2025) projects
53-
- [epipelargosy, an oceanography Jupyter book](https://github.com/robfatland/oceanography)
54-
- [steam: university-level STE(A)M notes](https://github.com/robfatland/steam)
55-
- [sodium: a study of distributed forms of information](https://github.com/robfatland/sodium)
56-
- [analytic number theory](https://github.com/robfatland/ant)
57-
- [middle school level STE(A)M outreach](https://github.com/robfatland/othermathclub)
37+
38+
## Other projects in process
39+
40+
- [epipelargosy, an oceanography Jupyter book](https://github.com/robfatland/oceanography)
41+
- [steam: university-level STE(A)M notes](https://github.com/robfatland/steam)
42+
- [sodium: a study of distributed forms of information](https://github.com/robfatland/sodium)
43+
- [analytic number theory](https://github.com/robfatland/ant)
44+
- [middle school level STE(A)M outreach](https://github.com/robfatland/othermathclub)

0 commit comments

Comments
 (0)