| tafkamax | If something can give their 2centz would be nice: https://www.reddit.com/r/openstack/comments/1elbd3e/neutron_provider_networks_with_multiple_vlans/ | 07:15 |
|---|---|---|
| tafkamax | s/something/somebody/, s/neutron_provider_networks_with_multiple_vlans/neutron\_provider\_networks\_with\_multiple\_vlans/ | 07:15 |
| TheJulia | Should the docs pages be doing file lists? https://docs.openstack.org/ironic/latest/admin/interfaces/ | 14:39 |
| TheJulia | fungi: ^ | 14:39 |
| fungi | TheJulia: if they don't include an index page, then yes | 14:42 |
| fungi | ideally ironic's docs would include a admin/interfaces/index.rst | 14:43 |
| fungi | but if a directory exists on docs.openstack.org and lacks an index.html file then apache will generate one with links to the files in that directory | 14:44 |
| TheJulia | I guess there are a couple where we don't have an distinct index for some reason, which is a little surprising in itself as well | 14:46 |
| fungi | TheJulia: other options would be to e.g. move interfaces/boot.rst to interfaces-boot.rst | 14:48 |
| * TheJulia shrugs | 14:49 | |
| fungi | similarly i see there's a drivers.rst but drivers/ without an index.rst, you could reorganize that by moving drivers.rst to drivers/index.rst | 14:49 |
| TheJulia | Someone is already working on reorganizing our docs | 14:49 |
| TheJulia | so this might just be a side effect as well | 14:49 |
| fungi | possible. mainly the goal with autoindexing like you spotted is to make sure that files don't "get lost" if nothing elsewhere in the docs is linking to them (granted, sphinx already emits warnings in such cases, so that shouldn't happen anyway for sphinx-built documentation) | 14:50 |
| fungi | it's more useful for other sites served from the same server, e.g. tarballs.opendev.org/openstack/ doesn't need an explicit index and automatically lists all the subtrees available there | 14:52 |
| fungi | ultimately, all our community content lives in public afs these days (browseable at /afs/openstack.org if you have afs configured on your machine), and these sites are just virtual hosts serving content from different parts of that global filesystem | 14:53 |
| fungi | for example, you can find the https://security.openstack.org/ site content in /afs/openstack.org/project/security.openstack.org/ | 14:54 |
| fungi | and the docs directory you pointed out is available at /afs/openstack.org/docs/ironic/latest/admin/interfaces/ | 14:56 |
| fungi | anyway, as for apache mod_autoindex behavior, i think it can be explicitly disabled in select subpaths with a .htaccess file, but i'd have to look into that and it might involve slight adjustments to the grants in the vhost configs | 14:58 |
| TheJulia | For context, I moved off this topic about 10 minutes ago | 14:58 |
| TheJulia | then again, based upon the time, it is time to open zoom :) | 14:58 |
| fungi | yeah, board meeting time | 14:58 |
| TheJulia | once coffee is prepared | 14:58 |
| *** ministry is now known as __ministry | 15:04 | |
Generated by irclog2html.py 2.17.3 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!