[a / b / c / d / e / f / g / gif / h / hr / k / m / o / p / r / s / t / u / v / vg / vm / vmg / vr / vrpg / vst / w / wg] [i / ic] [r9k / s4s / vip] [cm / hm / lgbt / y] [3 / aco / adv / an / bant / biz / cgl / ck / co / diy / fa / fit / gd / hc / his / int / jp / lit / mlp / mu / n / news / out / po / pol / pw / qst / sci / soc / sp / tg / toy / trv / tv / vp / vt / wsg / wsr / x / xs] [Settings] [Search] [Mobile] [Home]
Board
Settings Mobile Home
/g/ - Technology


Thread archived.
You cannot reply anymore.


[Advertise on 4chan]


File: Untitled.jpg (598 KB, 3264x2448)
598 KB JPG
Do you write good documentation for administering your personal setup? Which parts are most important to write down?
>>
File: 1698772170398048.png (477 KB, 567x654)
477 KB PNG
>>108830070
By administration do you mean my system's settings and preferences?
In that case, no not really, but I don't have a whole lot to remember either ways
>>
i did once, when I was really bored during covid
>>
>>108830070
hehe funny kitty cats :D
>>
i deliberately keep people at a distance do i dont need to explain or document anything.
>>
pfffft.. of course not
I just wrangle shit using the most half-baked half-solutions that get the thing I'm currently fighting working acceptably and move on. if it breaks some time down the line I just fix it in a similarly haphazard way
>>
>>108830070
for a personal setup (generally a list of programs, configs, dotfiles, etc) I use ansible. It has saved me a lot of time over the years.
no notes because it's generally self explanatory, just dump configs and install list of programs via package manager

---

for services and other things:
yes, everything I do is written down in notes
saves me so much time when I inevitability need to do it again

some tips you would probably figure out yourself:
1. make sure to keep links to whatever guides you are using, much faster than using search engines
2. don't be afraid to add keywords to sections so you can find it easier in the future (you should set up fzf, ag, etc in your editor)
3. use environment variables whenever you can in your commands, easier to update than replacing references
4. use a heredoc to for configs, appending to files, etc. Have one liners you can copy/paste to make small edits (via sed for example)

what makes this even more useful is having environment variables referenced.
generally you want to optimize your notes for blind copy/pasting instead of reading

export MY_VAR=abc

cat >> /etc/somefile.txt << EOF
# append this line
# can reference variables if you want
some_setting: $MY_VAR
EOF

# alternative format

cat <<EOF >> somefile.txt
# insert text here
EOF

# if you want to overwrite some file use a single >

cat > somefile.txt << EOF
# some content
EOF

cat <<EOF > somefile.txt
# some content
EOF




4. use markdown


personally while I learn something new I am writing my notes at the same time, this way I get to preserve every issue I encounter, saves me from running into the same issues. Having notes is something I wish I started sooner, they become more and more useful as time goes on and you forget details
>>
>>108830070
for anything i do on my server i take autistic notes and sometimes copy the entire terminal output for what i'm doing. it has saved me many times and makes it much easier to redo things
>>
>>108830070
>Which parts are most important to write down?

i jot down reproducible steps in markdown when i set up my servers. if i solve an interesting problem, then i have something to post online later as well.
>>
>>108830070
no, im schizoid. ill take any security i can, even by obscurity.
>>
>>108830070
Yes I take photos of my ram timings



[Advertise on 4chan]

Delete Post: [File Only] Style:
[Disable Mobile View / Use Desktop Site]

[Enable Mobile View / Use Mobile Site]

All trademarks and copyrights on this page are owned by their respective parties. Images uploaded are the responsibility of the Poster. Comments are owned by the Poster.