Issue872

Title Update infrastructure documentation
Priority wish Status resolved
Superseder Nosy List florian, jendrik, malte, silvan
Assigned To florian Keywords
Optional summary

Created on 2018-12-05.13:47:23 by florian, last changed by florian.

Messages
msg8243 (view) Author: florian Date: 2018-12-11.17:42:50
Done. I think this was the last remaining part of the issue.
msg8240 (view) Author: florian Date: 2018-12-11.17:27:07
Ok, I'll move them to infrastructure/doc.
msg8236 (view) Author: malte Date: 2018-12-11.17:17:50
In my opinion all of these except for the contacts.org file would fit the
infrastructure repository. (I think Gabi mentioned something similar.)
msg8234 (view) Author: florian Date: 2018-12-11.17:03:44
I updated the files in ai/admin as far as I knew the right information. The
following files remain there:

* aidev.org
  - List of services running on aidev
  - Update logs of previous OS upgrades
* backups.org
  - Description of backups of aidev/airepos
* contacts.org
  - contact information of group members
* howto.org
  - which tasks should involve an admin?
  - who has the password for X?
* icaps-videos.org
  - documentation of setup for the service
* infai-accounts.org
  - purpose of the accounts
  - how to access them

The first one overlaps a bit with the infrastructure repository where we also
have a list of services on aidev. How do we want to separate the two repositories?
msg8183 (view) Author: malte Date: 2018-12-07.15:56:14
I'm happy with the new documentation. We should also make sure to update the
ai-admin repository, in particular remove things we don't need any more.
msg8171 (view) Author: florian Date: 2018-12-06.16:53:32
There now is some documentation on roundup as well, in case someone wants to
review it.
msg8167 (view) Author: florian Date: 2018-12-06.15:46:51
I moved the buildbot documentation from ai/admin to ai/infrastructure and tried
to update it as much as I could. Could someone have a look? The change to
ai/admin just removes the complete directory "downward" which only contained
buildbot documentation. The new documentation in ai/infrastructure is structured
differently but I'll let you find this out (if it is not self-explanatory, we
should change it).

Also, I wrote this in org files without knowing the format, so someone with
emacs should probably check that things are indented correctly.

I'll try to write a similar documentation for roundup now.
msg8154 (view) Author: florian Date: 2018-12-05.16:16:45
Jendrik reviewed the change and we decided to merge it. I'll leave the issue
open until we fix the wiki and the documentation in the ai-admin repository.
msg8152 (view) Author: florian Date: 2018-12-05.15:31:09
I created a patch that removes the buildbot configuration that now lives in the
infrastructure repo and updates the documentation of the script:
https://bitbucket.org/FlorianPommerening/downward-issues/pull-requests/53

I found only one mention of the buildbot in our wiki. This should be updated to
document the tests we run but we should discuss the tests first.
http://www.fast-downward.org/ForDevelopers/BuildBot
msg8147 (view) Author: florian Date: 2018-12-05.13:47:23
Since we moved the buildbot to a docker container in our infrastructure
repository, we should update the relevant documentation in the Fast Downward
repository, the wiki, and the ai-admin repo.

I'm creating an issue for this, so we have a branch to make the changes in.
History
Date User Action Args
2018-12-11 17:42:50floriansetstatus: reviewing -> resolved
messages: + msg8243
2018-12-11 17:27:07floriansetmessages: + msg8240
2018-12-11 17:17:50maltesetmessages: + msg8236
2018-12-11 17:03:44floriansetmessages: + msg8234
2018-12-07 15:56:14maltesetmessages: + msg8183
2018-12-06 16:53:32floriansetstatus: chatting -> reviewing
messages: + msg8171
2018-12-06 15:46:51floriansetmessages: + msg8167
2018-12-05 16:16:45floriansetmessages: + msg8154
2018-12-05 15:31:09floriansetstatus: unread -> chatting
messages: + msg8152
2018-12-05 15:12:51silvansetnosy: + silvan
2018-12-05 13:47:23floriancreate