I've submitted a tutorial consisting of two pages that are intended to be placed under Site Building Guide, Geographic Information, OpenLayers. The titles are:

  1. OpenLayers Proximity Tutorial
  2. Proximity Filter Map Display

They can be found under Drupal 6.x, Developers and Coders, no known problems. I would appreciate it if someone would take a look at these and place them in the appropriate place.

Comments

arianek’s picture

arianek commented
Component: Placement/Navigation/Strucure » Correction/Clarification

Hi ccardea - can you post links to the pages here? Thanks.

ccardea’s picture

ccardea commented

Hello arianek,

As you wish:

OpenLayers Proximity Tutorial
OpenLayers Proximity Map Display

arianek’s picture

arianek commented
Project: Documentation » Openlayers
Version: » 7.x-2.x-dev
Component: Correction/Clarification » Documentation

Great - moving this to the OpenLayers queue, as I bet the maintainers would be good people to tech review this.

OL Maintainers, if you do not wish to review, please put back into docs queue. Also feel free to send back for a final style review. Thanks!

zzolo’s picture

zzolo commented
Project: Openlayers » OpenLayers Proximity
Version: 7.x-2.x-dev » 6.x-2.x-dev

Though, there is some base OpenLayers stuff in the tutorials, the bulk of it is using the OpenLayers Proximity module which is a separate project, that I personally have never used. So, I am going to move it to that queue.

As far as a base look over, the two pages look great. Awesome work!

If you want to take this further, I would suggest working on format a bit. You already are doing a pretty good job (better than most). But, when you are writing a long, multistep process like you are, its good to add some further formatting so that people can read things more quickly. I personally like to bold the action of the step and then add more text around why the step is necessary. For instance:

  1. Go ahead and do this step. You should see this happen. We need to perform this step so that blah knows about this other thing and the such. This allows people to read more when they get stuck, but otherwise they can quickly move through the tutorial.
ccardea’s picture

ccardea commented

OK I'll take a look and see where I can incorporate that.

ccardea’s picture

ccardea commented

OK, I did that where it seemed appropriate.

webchick’s picture

webchick
she/they
Primary language English
Location Vancouver 🇨🇦
commented
Status: Needs review » Reviewed & tested by the community

These tutorials are wonderful! They totally helped un-stick me on my quest to fix #1074208: Add a location field to group and event content types for g.d.o. I would never have figured out that bit about unchecking "force single" and "optional" on the proximity exposed filter, nor the weird way to actually get results showing in a map without them! ccardea++

I don't feel qualified to mark this "Fixed" since I'm not a maintainer of this module, but they're definitely "reviewed & tested". The only thing I changed was I added a bit about rebuilding the proximity index to the first tutorial, because I had enabled OpenLayers Proximity after I'd created some nodes and nothing was showing up.