{"action":"opened","issue":{"url":"https://api.github.com/repos/learningequality/ka-lite/issues/4106","labels_url":"https://api.github.com/repos/learningequality/ka-lite/issues/4106/labels{/name}","comments_url":"https://api.github.com/repos/learningequality/ka-lite/issues/4106/comments","events_url":"https://api.github.com/repos/learningequality/ka-lite/issues/4106/events","html_url":"https://github.com/learningequality/ka-lite/issues/4106","id":95284566,"number":4106,"title":"Docs tweaks for 0.14","user":{"login":"jamalex","id":618416,"avatar_url":"https://avatars.githubusercontent.com/u/618416?v=3","gravatar_id":"","url":"https://api.github.com/users/jamalex","html_url":"https://github.com/jamalex","followers_url":"https://api.github.com/users/jamalex/followers","following_url":"https://api.github.com/users/jamalex/following{/other_user}","gists_url":"https://api.github.com/users/jamalex/gists{/gist_id}","starred_url":"https://api.github.com/users/jamalex/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jamalex/subscriptions","organizations_url":"https://api.github.com/users/jamalex/orgs","repos_url":"https://api.github.com/users/jamalex/repos","events_url":"https://api.github.com/users/jamalex/events{/privacy}","received_events_url":"https://api.github.com/users/jamalex/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-07-15T20:35:51Z","updated_at":"2015-07-15T20:35:51Z","closed_at":null,"body":"Just in skimming the admin page docs, a huge number of things popped out as wrong. This page (and, I'm guessing others) need a thorough review and update, but I wanted to highlight the main things that popped out at me in my skim.\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#raspberry-pi\r\n\r\n`USE_MPLAYER` setting no longer exists, so this section can be deleted.\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#optimization-of-storage-and-system-load\r\n\r\n- `CRONSERVER_FREQUENCY`: description here is not quite right, as it only actually runs the sync cron job every hour, even though the cronserver runs every 10 mins (by default). Making this smaller won't increase the frequency of syncs, but making it longer than 1 hour will reduce the frequency.\r\n\r\n> This is how frequently KA Lite tries to synchronize user data with other Devices on your Zone.\r\n\r\nshould be\r\n\r\n> This is how frequently KA Lite tries to synchronize user data with the online Hub server.\r\n\r\n- `CACHE_TIME`: I don't think we're using the Django page cache any more, are we, @rtibbles? In any case, the description of what it does is now out of date.\r\n\r\n- `CHERRYPY_THREAD_COUNT`: We now hardcode this as `'server.thread_pool': 18,` in kalitectl.py, so this setting won't do anything\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#changing-base-settings\r\n\r\nThese instructions are incomplete (the example is missing). Also, what will go in the autogenerated settings.py if it's a Raspberry Pi -- will it automatically know to import the RPi base settings? Otherwise, it won't use the RPi settings by default, right?\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#running-ka-lite-with-your-own-settings\r\n\r\nIt would be clearer to have:\r\n\r\n> on Windows, locate C:\\Users\\<username>\\.kalite\r\n\r\nbe:\r\n\r\n> on Windows, locate C:\\Users\\<username>\\.kalite\\settings.py\r\n\r\nIs this currently the correct argument order, after @aronasorman's PR?\r\n\r\n> kalite <command> --settings=my_settings_module\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#updating-on-mac-os-and-linux\r\n\r\n- This doesn't seem to be updated at all. Updating from source is no longer recommended!\r\n\r\n- \"See the Windows installation guide\" isn't an actual link\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#downloading-videos-in-bulk\r\n\r\nWe no longer support BTSync. Traditional torrent files should be downloaded from https://learningequality.org/downloads/ka-lite/0.14/content/\r\n\r\n---\r\n\r\nhttp://field.learningequality.org/develop/docs/en/usermanual/userman_admin.html#administrator-glossary\r\n\r\n> \"A sharing network is a group of devices that share data between one another. Data can mean video content, access software applications, and certain files.\"\r\n\r\nis incorrect, and should be changed to:\r\n\r\n> \"A Sharing Network is a group of devices that share user data. This data is synced to the central server when an Internet connection is available, and then synced down onto other devices in the same Sharing Network.\"\r\n\r\n> \"A device should be able to run a KA Lite server (most computers) and other devices to be used as clients. [...]\"\r\n\r\nshould be changed to:\r\n\r\n> \"A Device is a computer running the KA Lite server software. Each Device has a name and unique ID, stored in the KA Lite database on that device.\"\r\n\r\nThe following definitions are confusing and unnecessary, and should be deleted:\r\n\r\n> \"Torrent\", \"Seeder\", \"Bandwidth\"\r\n"}}