This isn't really an issue, just...

[jyeager11]

This isn't really an issue, just a comment : First, let me state that I've been designing websites since 1997, and while I do know my HTML and CSS pretty well at this point, I don't know any javascript. That being said, I've always been able to successfully implement scripts, from jQuery to mooTools and everything in between.

Now, I just spent 3 days trying to get this to work, and am having the hardest time, because I don't know javascript. I'm not saying your installation notes aren't well-written. I'm sure they are. But if you dumb them down another notch, you will see a much wider audience starting to use this script in all their site designs. People like me.

Something simple like : 1) Copy this text here. 2) Copy this file here. 3) Use this file only if you need [insert feature here]. etc.

Right now, after 3 days of trial and error, I seem to have it working by copying the function call word for word... but the sections won't vertically center like they do in the sample pages. And I still don't know what modernizr and flexi do, and whether or not I need to copy those too. Know what I mean?

I really want to make this thing a part of the sites I'm putting together, but the docs need to be dumbed down a bit further.

embarrassed look

[imakewebthings]

Hi @jyeager11, first of all, thanks for taking such an interest in Waypoints. Suggestions from folks of all JS skill levels are welcome and essential for gaining a different perspective on the project.

I think some of the confusion stems from what role I believe Waypoints plays in a developers arsenal. My intention, and how it has been written, is as a tool for JS developers that takes a sometimes rough browser action (scroll) and turns it into a slightly higher level abstraction (when element X hits position Y in the viewport, fire function Z). This resulting abstraction is still relatively low-level, in that a developer still needs to understand how to put those pieces together, and what to do within the function that is executed.

You haven't actually stated what you were trying to accomplish, only that it wasn't working, but I suspect you were trying to replicate one of the examples or some functionality on the project page itself. Waypoints is not a drop-and-go plugin for sticky elements, infinite scroll, or any of the other examples. The example pages are recipes that work for those specific pages alone, and are meant only to serve as code samples for how one might use the waypoint function. If you're looking for scripts that do these things out of the box, I can set you on a few paths with recommendations. Just let me know what you're trying to do.

Some stray answers to specifics: Modernizr and Flexie both give top Google results, but to summarize, Modernizr is a feature detection library + HTML5 shim. Flexie is a polyfill that gives CSS3 Flexible Box Model support to older browsers using JavaScript. I use both on the project page to support my CSS3 decisions with that design. They have no bearing on the Waypoints library, and you'll notice they aren't included in the download. Waypoints only requires including waypoints.js or waypoints.min.js and then you'll have access to the $.waypoints() and $(someSelector).waypoint() methods.

Hope this has been helpful in some way. I'm going to close this, since as you said it's not really an issue, but feel free to continue discussing in this thread. Or you can reach out to me directly, whatever works for you.