diff --git a/org/_proto.org b/org/_proto.org index b5fbfc9..ef6e836 100644 --- a/org/_proto.org +++ b/org/_proto.org @@ -10,6 +10,39 @@ The next step is that I would like to have a tsr/nn base that has one doc that h After that I would like to articulate / implement a file directory structure standard for all of these projects. ** TODOS +*** TODO establish a standard directory structure for projex repos +notes: [[standard docs]] +I propose: + 1. a docs/ folder with org/, html/, md/ (for now) + 2. scripts/ <-- not sure about this one. For my purposes this is text processing so should probably go in docs/ ? but for now whatever + 3. src/ (for projects w/ executable code + 4. index.html, README.md at the root + +**** README +a 1-paragraph concise summary of: +- the goal / purpose +- the context (e.g. audience, who has access to the project, whether the repo is public/private, etc) +- how to get new people involved in the project + (we will need a overarching overview that explains the process which I will get to when I can) +**** TODOs +the todo contains things that actually need to be done (i.e. action items, these can be linked to pull requests or issues, and eventually we can probably even set up hooks etc.) + +the thing that would be REALLY NICE about having these be separate files called todo.org is that it would make it easy to add them to agenda mode. +on the other hand, then there would be too many todo.org files. + +I also decided I hate the idea of breaking these up into multiple files. + +For now I will be including a file _projectName.org in org/ and in .gitignore that I will organize like this one. If I can figure out how to export those separte headers I will; otherwise I"ll do it manually for now. +**** notes + +I want to keep track of these but I don't necessarily want them cluttering up the repos. I use them for, e.g. walking kittens through tutorials, asking you questions and getting answers, etc. I have been putting a notes directory in .gitignore for now I'm going to probably leave this in TODOs because I'm not sure what the answer is yet. + +*** TODO decide on a workflow for exporting html files to /var/www +I'm reluctant to write these directly with a hook because not everything will be ready, some will be a work in progress. + +I kind of like the idea of having /var/www/irc.anarchyplanet.org/dox being another repo of dox that pulls only a 'build' branch or something similar, and this build branch having a web hook that runs the pandoc script. That way all of the md and html files will be automatically updated. + +(I know that the 'master' branch would be the standard convention but becuause we don't have branch protection I just think doing an unconventional branch would be easier) *** TODO decide on / create a tsr/nn base It's kind of looking like /root/serge/docs/serverl337.org is becoming that base? nn is trying to adapt to tsr's process too :) @@ -30,21 +63,6 @@ etc. ***** ircbang ***** etc. e.g., things here: https://irc.anarchyplanet.org/git/explore/repos -*** TODO establish a standard directory structure for projex repos -see [[export_headlines]] -I propose the folder structure we've started with org/ , /html , etc. And then either a single document with three sections or the three following files: -**** README -- the goal / purpose -- the context (e.g. audience, who has access to the project, whether the repo is public/private, etc) -- how to get new people involved in the project - (we will need a overarching overview that explains the process which I will get to when I can) -**** TODOs -the todo contains things that actually need to be done (i.e. action items, these can be linked to pull requests or issues, and eventually we can probably even set up hooks etc.) -the thing that would be REALLY NICE about having these be separate files called todo.org is that it would make it easy to add them to agenda mode. -**** notes - -I want to keep track of these but I don't necessarily want them cluttering up the repos. I use them for, e.g. walking kittens through tutorials, asking you questions and getting answers, etc. I have been putting a notes directory in .gitignore for now I'm going to probably leave this in TODOs because I'm not sure what the answer is yet. - *** TODO document an onboarding sequence for AP projex ppl - something like: - SSH @@ -53,8 +71,7 @@ I want to keep track of these but I don't necessarily want them cluttering up th - hidden services - pandoc ** notes -*** function for exporting headlines as separate documents -#+NAME: export_headlines +*** standard docs I decided that I kind of hate the idea of breaking this up into three files, so I'm currently looking to see if it's possible to export subjections of a single file, e.g. https://emacs.stackexchange.com/questions/40870/under-org-mode-save-section-of-file-to-another-file @@ -70,19 +87,16 @@ But... if I didn't really care about that I'm sure there'd be another way to fix Or, maybe it makes more sense to open the three files in three separate buffers.... I like the idea to merge stuff it is on the same topic. -wow, this function actually works REALLY well! - -which? also what was that cool undo tree earler? - -it's a package called undo-tree :) - -#+NAME: tsr/nn base +*** show undo tree: install undo-tree +*** tsr/nn base + Another step is coming up with an admin/dev process (i.e. tsr and notnull) -I thought that using README.org would be a good way to have the one intro document but I'd say the main function of README.md is to give outsiders an overview of the project, so it doesn't make sense for dev todos and notes. +I thought that using README.org would be a good way to have the one intro document but I'd say the main function of README.md is to give outsiders an overview of the project, so it doesn't make sense for dev todos and notes. +1 -One option might be to have a centralized org doc that links to the directories for our other projects, with TODOs. +One option might be to have a centralized org doc that links to the directories for our other projects, with TODOs. +1 linking indices among proj would help -Ideally, each directory will have a file (thinking todo.org) that has the todos. then the central document will link to each project directory's todos (also, I will show you about how to use agendamode). +Ideally, each directory will have a file (thinking todo.org) that has the todos. - superseeded by agenda mode? +then the central document will link to each project directory's todos (also, I will show you about how to use agendamode). and then each of these will have a repo and then a directory with the file struture outlined in projex (directories = org md html etc etc) and then the files README, todo, and notes can be in any or all of these. @@ -90,18 +104,6 @@ that way when I'm like 'what is tsr working on that I need to know about?' It ca I am not opposed to autoamating the generation of that process by hitting an api that gogs has for that expore place, for example. (or building an API) -For me it's like figuring out prios atm. Need to restore my files and have to test cryptsetup more and procastinate very well. - -what happened to your files? also, re: cryptsetup, that is something for serge backup or something you're doing independently? or both? -The debian installer overwrote the partition table and i need to find the partition start or if it got overwritten bruteforce it which somehow seems unlikely to work. - -:( sux! -Still interesting to get familiar with. just need to start and write scripts or test hash..something - backup on serge is a good opportunity. - -perfect! also I was thinking about maybe eventually setting up an encrypted partition here. but yeah, that is cool! let me try to create that loop device atached to a container. - -sounds good to me! I will be working on this organizing I've mentioned here, and also if you work on cryptsetup on wemux I'll check in :) k - - -also re: gogs explore/repo thx for pointing that out... solike, if ircbang wants a list of todos that people could help with, I would want it to take the form of what we did with the irc-how-to for example, where now it is implemented in text, git, etherpad, etc. +*** TODO fix M-N-left subtree denoting +*** also re: gogs explore/repo thx for pointing that out... solike, if ircbang wants a list of todos that people could help with, I would want it to take the form of what we did with the irc-how-to for example, where now it is implemented in text, git, etherpad, etc. diff --git a/org/notes.org b/org/notes.org deleted file mode 100644 index 3a77944..0000000 --- a/org/notes.org +++ /dev/null @@ -1,20 +0,0 @@ -:PROPERTIES: -:EXPORT_FILE_NAME: notes -:END: -* function for exporting headlines as separate documents -I decided that I kind of hate the idea of breaking this up into three files, so I'm currently looking to see if it's possible to export subjections of a single file, e.g. - -[[https://emacs.stackexchange.com/questions/40870/under-org-mode-save-section-of-file-to-another-file]] - -This works well but (1) I don't like how it adds the :PROPERTIES: drawer automatically to the headline, (2) It would need to have an option for controlling the depth, (3) it currently writes pdfs using latex, and the syntax would have to be changed a bit in order to make it work for exporting text. etc. - -Anyway, this is peak autismo :P - -Or, maybe it makes more sense to open the three files in three separate buffers.... -I like the idea to merge stuff it is on the same topic. - -wow, this function actually works REALLY well! - -which? also what was that cool undo tree earler? - -it's a package called undo-tree :)