Readme - pub/scm/docs/kernel/ksmap - Git at Google

 Kernel.org keysigning map
 ~~~~~~~~~~~~~~~~~~~~~~~~~

 About
 ~~~~~
 The project is realized with leafletsjs [0] and uses Openstreetmap [1] to
 render the map. Each kernel.org account holder may put a place mark to show the
 world where they might be available for a keysigning.

 Privacy
 ~~~~~~~
 The source repository is public, so when you pick coordinates, PLEASE be
 mindful of your privacy. The last thing you want is someone knocking on your
 door demanding that you fix their computers. It is recommended that you only
 list the city centres in the source YAML files, unless you really like
 uninvited visitors.

 How to get on the map?
 ~~~~~~~~~~~~~~~~~~~~~~
 Find out your coordinates (latitude,longitude). Nominatim can help with this:

   - http://nominatim.openstreetmap.org/

 Search for your City name, then click "Details" and copy-paste "Centre Point"
 coordinates as shown on the results page. If you obtain the coordinates via
 some other means, make sure they are in the 'latitude,longitude' order expected
 by the script.

 Once your have your coordinates, create a new file in users/[username].yaml
 where [username] is your kernel.org account name. See other examples already
 there, and also a commented "sample.yaml" in toplevel directory. You can list
 multiple locations and specify in the description the frequency at which you
 may be found at each one.

 You may then preview the results by running:

   ./yaml-to-kml.py -f users/[username].yaml -o www/developers.kml
   firefox www/index.html

 You might need to temporarily change the privacy.file_unique_origin in
 about:config to allow accessing local resources in page directory.  Disable the
 setting after tests.

 If all looks good, you need to push this information back into the kernel.org
 repository.  Once we have collected enough initial data, we will integrate the
 map into the main kernel.org website.

 [0] http://leafletjs.com/
 [1] http://www.openstreetmap.org/
	Kernel.org keysigning map
	~~~~~~~~~~~~~~~~~~~~~~~~~

	About
	~~~~~
	The project is realized with leafletsjs [0] and uses Openstreetmap [1] to
	render the map. Each kernel.org account holder may put a place mark to show the
	world where they might be available for a keysigning.

	Privacy
	~~~~~~~
	The source repository is public, so when you pick coordinates, PLEASE be
	mindful of your privacy. The last thing you want is someone knocking on your
	door demanding that you fix their computers. It is recommended that you only
	list the city centres in the source YAML files, unless you really like
	uninvited visitors.

	How to get on the map?
	~~~~~~~~~~~~~~~~~~~~~~
	Find out your coordinates (latitude,longitude). Nominatim can help with this:

	- http://nominatim.openstreetmap.org/

	Search for your City name, then click "Details" and copy-paste "Centre Point"
	coordinates as shown on the results page. If you obtain the coordinates via
	some other means, make sure they are in the 'latitude,longitude' order expected
	by the script.

	Once your have your coordinates, create a new file in users/[username].yaml
	where [username] is your kernel.org account name. See other examples already
	there, and also a commented "sample.yaml" in toplevel directory. You can list
	multiple locations and specify in the description the frequency at which you
	may be found at each one.

	You may then preview the results by running:

	./yaml-to-kml.py -f users/[username].yaml -o www/developers.kml
	firefox www/index.html

	You might need to temporarily change the privacy.file_unique_origin in
	about:config to allow accessing local resources in page directory. Disable the
	setting after tests.

	If all looks good, you need to push this information back into the kernel.org
	repository. Once we have collected enough initial data, we will integrate the
	map into the main kernel.org website.

	[0] http://leafletjs.com/
	[1] http://www.openstreetmap.org/