Meta tags:

Headings (most frequently used words):

the, version, released, to, and, decoded, support, interface, new, documentation, for, laws, improved, search, command, line, of, help, legal, export, add, or, an, provide, post, navigation, state, miami, dade, launches, edition, database, versioning, municode, parser, much, more, user, engine, code, base, overhaul, setup, simplified, plus, as, continuous, process, site, san, francisco, don, let, perfect, be, enemy, good, how, you, can, first, release, codes, humans, pinned, better, inconsistent, data, import, improvements, tool, create, functionality, portfolio, memcached, elasticache, establish, showing, diffs, law, word, pdf, epub, option, use, opendyslexic, font, sync, github, vagrant, configurations, display, related, self, documents, edit, write, propose, changes, tuning, caching, development, environment, standardization, extensibility, features, main, menu, praise, awards, recent, posts,

Text of the page (most frequently used words):
the (237), and (127), that (79), for (53), #decoded (52), state (50), this (48), now (36), documentation (32), with (32), laws (31), code (27), are (27), can (25), there (24), new (24), #github (23), version (21), legal (21), have (21), posted (20), all (19), search (17), law (16), but (16), release (15), data (15), was (15), from (14), which (14), work (14), made (13), project (13), software (13), you (12), versions (12), has (12), add (12), their (12), also (12), create (12), more (12), how (12), system (12), they (12), who (11), some (11), out (11), changes (11), available (11), not (11), process (10), released (10), site (10), will (10), about (10), solr (10), those (10), waldo (10), jaquith (10), issue (10), codes (9), support (9), easier (9), folks (9), vagrant (9), repository (9), were (9), open (9), people (8), john (8), help (8), wiki (8), been (8), database (8), best (8), website (8), when (8), better (8), every (8), needs (8), somebody (8), use (8), because (8), source (8), make (7), foundation (7), features (7), lot (7), these (7), few (7), just (7), what (7), any (7), own (7), html (7), run (7), development (7), its (7), 2013 (7), list (7), provide (7), interface (7), too (7), design (7), display (6), only (6), based (6), improvements (6), within (6), through (6), page (6), your (6), text (6), php (6), great (6), them (6), parser (6), others (6), xml (6), would (6), write (6), then (6), may (6), time (6), editions (6), other (6), creating (6), possible (6), opengov (6), engine (6), import (6), tool (6), miami (5), our (5), api (5), general (5), issues (5), bill (5), users (5), each (5), both (5), inc (5), default (5), setup (5), line (5), than (5), here (5), major (5), done (5), easy (5), pages (5), means (5), first (5), self (5), way (5), edition (5), functionality (5), using (5), like (5), used (5), without (5), command (5), platform (4), court (4), news (4), navigation (4), comprised (4), months (4), into (4), team (4), apache (4), meticulous (4), over (4), course (4), pull (4), requests (4), environment (4), makes (4), contribute (4), already (4), started (4), see (4), making (4), built (4), markdown (4), even (4), section (4), know (4), aren (4), suggestions (4), pretty (4), hard (4), part (4), need (4), good (4), let (4), word (4), pdf (4), epub (4), entire (4), table (4), where (4), never (4), comes (4), right (4), always (4), san (4), francisco (4), long (4), hosting (4), needed (4), multiple (4), structure (4), content (4), adapter (4), previous (4), powered (3), dade (3), posts (3), ever (3), user (3), information (3), services (3), embedded (3), james (3), knight (3), thanks (3), dedicated (3), several (3), dozen (3), connections (3), athayde (3), tasks (3), hunt (3), commenting (3), config (3), obvious (3), stored (3), standard (3), style (3), prior (3), wrong (3), future (3), machine (3), download (3), path (3), worth (3), configuration (3), caching (3), cached (3), releases (3), faster (3), large (3), mysql (3), memory (3), git (3), being (3), created (3), jekyll (3), simple (3), example (3), understand (3), looks (3), able (3), allows (3), related (3), home (3), various (3), enable (3), jquery (3), font (3), option (3), since (3), structural (3), export (3), look (3), cache (3), rather (3), memcached (3), most (3), portfolio (3), september (3), third (3), having (3), linked (3), far (3), inconsistent (3), still (3), added (3), copy (3), downloads (3), automatically (3), automated (3), number (3), much (3), current (3), pinned (3), wordpress (2), continuous (2), launches (2), anyone (2), read (2), virginia (2), understandable (2), regular (2), definitions (2), terms (2), robust (2), grant (2), older (2), post (2), outstanding (2), branch (2), lynn (2), wallenstein (2), involved (2), core (2), contributor (2), responsible (2), very (2), bug (2), chris (2), birk (2), couldn (2), keyboard (2), structures (2), power (2), disqus (2), running (2), bulk (2), plain (2), json (2), steps (2), customization (2), non (2), storing (2), metadata (2), fields (2), late (2), formatting (2), establish (2), contributors (2), customize (2), tidy (2), pdo (2), many (2), substantially (2), resulting (2), tiny (2), image (2), trivial (2), working (2), deploy (2), configurations (2), instances (2), why (2), under (2), either (2), apc (2), could (2), ways (2), whole (2), methods (2), error (2), efficient (2), previously (2), might (2), really (2), commits (2), commit (2), went (2), combined (2), structured (2), material (2), sample (2), reflected (2), anybody (2), moved (2), everything (2), interesting (2), relatively (2), contained (2), complete (2), review (2), hosted (2), directly (2), technical (2), edit (2), propose (2), documents (2), store (2), document (2), identify (2), match (2), effort (2), set (2), implementation (2), method (2), given (2), widget (2), cookie (2), opendyslexic (2), imported (2), portions (2), should (2), three (2), separate (2), projects (2), unit (2), class (2), compare (2), two (2), changed (2), upon (2), pre (2), server (2), keep (2), localstorage (2), something (2), second (2), doesn (2), forward (2), come (2), radar (2), england (2), said (2), terrible (2), citizens (2), cross (2), references (2), states (2), sure (2), present (2), problems (2), years (2), think (2), perfect (2), legislators (2), identified (2), properly (2), rulings (2), specific (2), don (2), nice (2), before (2), launched (2), raw (2), his (2), requires (2), same (2), itself (2), publishing (2), via (2), modified (2), change (2), year (2), facilitates (2), workflow (2), files (2), later (2), had (2), around (2), seemed (2), public (2), modifications (2), web (2), improvement (2), early (2), meant (2), task (2), throughout (2), things (2), did (2), big (2), install (2), format (2), single (2), instead (2), plan (2), file (2), host (2), statedecoded (2), november (2), wouldn (2), generous (2), ongoing (2), employs (2), xslt (2), included (2), require (2), identifiers (2), allow (2), test (2), base (2), took (2), routing (2), old (2), overhaul (2), berryman (2), doug (2), turnbull (2), live (2), one (2), scratch (2), different (2), biggest (2), community (2), including (2), corporation (2), ability (2), removes (2), updating (2), well (2), easily (2), choose (2), between (2), additional (2), improved (2), show (2), 2015 (2), stable (2), press (2), handling (2), identifier (2), sections (2), effectively (2), main (2), pin (2), humans (2), skip (2), proudly, recent, awards, tried, failed, bristol, herald, courier, astonishingly, friendly, nieman, journalism, lab, prettiest, seen, harvard, university, praise, decisions, legislative, tracking, featuring, beautiful, typography, funded, winner, 2011, challenge, next, soon, close, together, baking, finished, earlier, week, build, osc, valuable, opensource, handful, small, remaining, four, scrubbed, helpful, reports, edits, came, daniel, trebbien, resist, want, flip, quickly, baked, enter, shortname, finally, generation, end, dunno, figure, facilitate, columns, commented, infrastructure, inline, distributed, importing, arbitrary, alongside, extensibility, nineties, pear, nothing, approaches, expect, installed, systems, simplifies, mdb2, purifier, standardization, developed, staging, inevitable, optimization, respecting, port, numbers, urls, collectively, smooth, experience, developing, locally, get, bandwagon, hopping, aws, hooks, popular, applications, reap, speed, benefits, keys, constants, templates, tap, upcoming, varnish, reviewed, replaced, tossing, starting, again, indices, evaluated, revised, level, above, quieted, usage, reduced, strained, broken, per, limit, e_notice, strpos, strstr, stristr, tuning, meaty, entirely, optimizations, extend, navigate, whopping, 353, june, deal, organized, narratively, enhanced, illustrations, simply, cover, bad, piecemeal, mix, difficulty, promptly, update, fix, mistake, draft, august, isn, awaiting, creation, strongly, benefit, detail, mindset, beginners, proposed, form, report, decent, active, crack, interfacing, probononet, gather, free, extended, relevant, promoting, got, elements, place, lack, glue, say, foreclosure, probably, guide, foreclosed, 162, underway, ready, sub, couple, issued, logged, tracker, 284, psyched, putting, reasons, specified, necessary, options, 161, sync, disable, setting, toggle, typeface, body, 340, article, thereof, realistically, ideally, chapter, title, etc, parsercontroller, tracked, 363, showing, diffs, connect, object, choice, modify, reading, presumably, requested, loading, full, liable, fit, reasonable, amount, 263, elasticache, ought, track, interest, removeitem, setitem, received, mail, day, asking, rule, sign, doing, spirit, addressing, diverse, await, addition, interested, levels, knowledge, expertise, exist, yet, obviating, sir, robert, alexander, watson, watt, pioneer, detect, approaching, luftwaffe, give, websites, picked, random, awful, percentage, capable, navigating, understanding, rounding, cases, access, maine, york, missouri, south, carolina, technologically, solve, inherent, bright, minds, looked, past, decided, against, insurmountable, obstacles, scope, conclude, shouldn, proceed, anyway, 100, defined, words, hierarchical, indented, labelled, inconsistently, ruling, apis, return, affect, opposed, merely, courts, mention, definition, scraper, perfectly, basic, concept, behind, hadn, enemy, member, today, puts, online, provided, growing, bravo, cio, jay, nath, happen, mayor, office, civic, innovation, remains, actively, maintained, hope, reflects, ecosystem, route, wise, follow, intervening, notable, basically, dressed, mess, ago, restructured, ordered, edited, desktop, hundreds, times, walked, minutes, fine, didn, cast, find, clear, recommended, trying, published, authorized, accepted, saved, party, order, marked, prose, short, perhaps, important, adopters, try, providing, sufficient, releasing, getting, unwieldy, contributing, worked, became, works, wrote, harder, authored, bare, bones, notes, established, required, internal, definitely, another, turns, realization, wasn, born, moment, during, product, include, com, model, emulate, karl, nicholas, nick, skelsey, josh, tauberer, rostislav, tsiomenko, testing, contributed, whose, funding, hire, courtesy, employer, him, implement, cities, handle, supports, unique, proper, administrative, sitemap, generated, dublin, assets, photoshop, plus, tested, linux, distributions, platforms, smoothly, environments, accordingly, environmental, suite, paths, accomplishing, little, configure, installation, fewer, possibly, simplified, complexity, outgrew, functioned, completing, weeks, implementing, moving, controllers, queries, permalinks, approach, clunky, compared, insulting, call, mere, designed, optimized, spellcheck, indexed, underlying, lucene, sorts, exciting, realms, natural, language, processing, retrieval, recommendations, learning, dropping, rendered, almost, unrecognizably, highly, modular, flexible, screens, sizes, continue, grow, layout, coded, handy, designers, pluggable, template, drop, custom, designs, print, stylesheet, hand, overstating, huge, sass, date, combination, twice, produce, planned, 709, committed, eight, final, total, responsive, integration, rundown, fund, ingersoll, fixing, amazing, members, erik, hatcher, lucidworks, fixes, tweaks, accessibility, municipal, along, american, generic, improves, localities, codifier, municode, updated, delete, package, called, imports, scheduled, basis, cron, versioning, refactored, abstract, result, jump, hoops, abstraction, engines, writing, wanted, elasticsearch, optional, uses, packages, extra, powerful, solution, admins, replace, parallel, locality, updates, historical, record, browse, kept, isolate, differences, wikipedia, completes, fundamental, potentially, breaking, installations, announced, beta, brigade, america, last, real, joint, december, plenty, welcome, downloaded, manage, automate, reworked, plugin, architecture, formats, overhauled, mixed, units, supported, uniform, consistent, paragraphs, repealed, numbering, led, inconsistencies, labelling, originally, represented, share, response, identical, such, viewed, hiding, save, favorite, click, icon, key, highlights, marks, official, feature, april, 2017, contact, places, menu, secondary, primary,

Text of the page (random words):
other page on the wiki things were getting unwieldy as more people started contributing to the project not only did more people need to understand how the software worked but it also became hard to keep up with improvements to the code it s easy to understand how software works when you wrote all of it but it s rather harder when big portions of it were authored by others perhaps most important it needed to be easier for early adopters to try out the state decoded before its v1 0 release and that meant providing documentation that was sufficient for that task releasing software throughout the development process in the open source style means that documentation needs to be released throughout too in short open source software requires open source documentation there are some fine services available for hosting software documentation but i didn t have to cast around long to find a clear path forward for the state decoded github pages several people recommended it so it seemed worth trying github pages allows html and markdown stored on github to be published to a public website using jekyll an open source project as with any github repository others can make pull requests to propose modifications to those web pages or be authorized to make any modifications that they like when those changes are accepted or saved they re reflected on the public website thanks to third party services like prose io somebody need not even know how to use git or github or even html or markdown in order to edit the documentation this is a marked improvement over wiki hosted documentation github pages is github s github s setup process walked me through creating a state decoded documentation repository to which i moved the files from the wiki minutes later the project had a documentation website in the intervening few months the documentation has been modified every time that a notable change was made hundreds of times in all that said it s still basically a dressed up version of the wiki based mess of a year ago it needs to be restructured ordered and edited but now it s on a platform that facilitates those improvements by making it part of my desktop development workflow as long as the state decoded remains an actively maintained project for years to come i hope it needs to have documentation that reflects that that requires documentation that changes with the software and that is part of the same ecosystem as the software itself hosting software documentation on github and publishing it via jekyll is the right path for the state decoded and i think it s a route that other open source projects would be wise to follow too posted in general new site san francisco decoded posted on september 26 2013 by waldo jaquith today the opengov foundation launched san francisco decoded their state decoded powered website that puts the laws of san francisco online the site is possible because the san francisco mayor s office of civic innovation provided the raw text of their laws which the growing team at opengov used as the raw material to power the website bravo to sf cio jay nath his team and the folks at opengov for their great work in making this happen posted in member site don t let the perfect be the enemy of the good posted on september 23 2013 by waldo jaquith the basic concept behind the state decoded is both simple and obvious create a platform to display laws in a nice understandable way using the data already present in those laws so why hadn t anybody done it before because it s too hard to do perfectly the state decoded is not perfect by design its definition scraper may never identify 100 of defined words within legal codes because legislators are inconsistent about how they write laws cross references will not always been identified and linked because they re legislators are inconsistent about how they write those too some laws hierarchical structures may not be indented properly because they re labelled inconsistently the state decoded s interface with court ruling apis may never return only the court rulings that affect a specific law as opposed to rulings that merely mention a law because courts don t provide metadata i m not sure that it s technologically possible at present to solve these and a dozen other problems inherent in the state decoded some very bright minds have looked at creating a state decoded like system over the past few years and decided against it because of insurmountable obstacles they were right about the scope of the problems but i think they were wrong to conclude that they shouldn t proceed anyway and create a system that s 99 of the way there just look at a few state code websites i picked a few out at random south carolina missouri new york and maine these are awful just terrible the percentage of citizens who are capable of navigating and understanding these is a rounding error having embedded definitions for 99 of legal terms cross references linked 99 of the time and linked court cases that are good not great that s all far far better than what the citizens of these states have access to right now sir robert alexander watson watt the radar pioneer who created england s system to detect approaching luftwaffe said of england s radar system give them the third best to go on with the second best comes too late and the best never comes the state decoded is the third best system the second best doesn t exist yet but i look forward to somebody creating it and obviating the state decoded the best may never come and that s ok posted in general how you can help posted on september 16 2013 by waldo jaquith i received an e mail the other day from somebody asking how he could contribute to the development of the state decoded as a rule this is a sign that i m doing something wrong in the spirit of addressing that that here are a list of relatively self contained interesting diverse features that await addition to the state decoded that you or somebody you know might be interested in creating for folks of all levels of technical knowledge and many fields of expertise create the functionality to add laws to a portfolio site users ought to be able to keep track of laws that are of interest of them using jquery s localstorage setitem localstorage removeitem provide the functionality to let people add laws to a portfolio and then create a page where people can see a list of the laws in their portfolio issue 30 support memcached and or elasticache provide an option in config inc php to provide configuration information to connect to the object cache of choice and modify class law inc php to cache laws within the cache upon reading them or if already cached read them from there rather than the database presumably laws should be cached in memcached upon being requested rather than pre loading memcached full of all laws since most legal codes aren t liable to fit within a reasonable amount of server memory issue 263 establish an interface for showing diffs of a law with each new release of a legal code we add a new edition tracked in the editions table and add all of those new laws to the laws table provide the functionality to let somebody look through the various versions of a law over time or compare two versions to see how they ve changed issue 363 add word pdf and epub export add new methods to class parsercontroller inc php to create at the time that a legal code is imported word pdf and epub versions of the legal code and portions thereof realistically this should be three separate issues since it s three separate projects ideally there d be word and pdf versions of every law every structural unit chapter title etc and the entire legal code and then epub versions of every structural unit and of the entire legal code issue 50 provide an option to use the opendyslexic font create a jquery based widget to let somebody enable or disable the use of the opendyslexic font by setting a cookie and then a jquery based widget to toggle the use of that typeface for the body font article law if that cookie is set issue 340 sync laws to github some folks are pretty psyched about putting laws on github for various reasons create a method that will commit the plain text version of all laws in a given edition of the legal code to a specified github repository and add the necessary options to config inc php to enable that issue 161 provide vagrant configurations there s an effort underway to create a ready to go vagrant configuration of the project so that it s trivial for somebody to set up an implementation of the state decoded on their own system this sub project has its own repository and a couple of issued logged in its own issue tracker issue 284 display related legal self help documents i ve made a first crack at interfacing with probononet s api to gather up a list of all of their free self help legal documents this needs to be extended to store this data in a way that s available to the state decoded and then here s the hard part when somebody looks at a law for which there s a relevant self help legal document available we need to be able to identify that document and display text promoting it we ve got the ui elements in place for this but we just lack the glue that allows us to say this law about foreclosure is probably related to this guide about what to do if your home is being foreclosed on solr may be a good way to make this match issue 162 edit write or propose changes to documentation the state decoded has some pretty decent documentation that s under active development but it would strongly benefit from review by people who aren t contributors to the project people who already know a project in great detail aren t in a great mindset to write about it in a way that beginners can understand the documentation is hosted on github so pull requests can be made directly or for folks who aren t technical suggestions or proposed changes can be made in the form of an issue report documentation repository this isn t everything that needs to be done of course these are just the interesting relatively self contained new features you can see the complete list of outstanding issues on github or just the list of new features awaiting creation posted in how to first documentation release posted on august 9 2013 by waldo jaquith the first draft of the state decoded s documentation is now available documentation was being built up piecemeal on a github wiki but it s been moved to its own github repository and a dedicated website the pages are created in a mix of html and markdown markdown has difficulty with some of the sample xml and the site is built in jekyll which means that any changes made in the documentation github repository are reflected promptly on the documentation website this makes it simple for anybody to update the documentation to fix a mistake add an example or even add a whole new section there s a great deal more to be done with the documentation it needs to be organized structured narratively enhanced with illustrations and simply cover more material but it s not bad and now it s easy for others to help make it better posted in news version 0 7 released posted on june 20 2013 by waldo jaquith version 0 7 of the state decoded is now available on github this is a really meaty release dedicated entirely to optimizations it s faster more efficient easier to extend easier to contribute to easier to deploy and easier to navigate this release is comprised of a whopping 353 git commits that s more than every commit that went into versions 0 1 through 0 6 combined here are some of the major changes tuning every line of code was reviewed to see how it could be made faster in tiny ways instances of stristr replaced with strstr or better strpos and in large ways tossing out whole methods and starting again the indices in mysql were evaluated and revised and any php error of level e_notice and above was quieted and the parser s memory usage has been reduced substantially making it faster and more efficient to process large legal codes that previously might have strained or broken apache s per process memory limit caching there are now hooks for both apc and varnish so that folks running either of those popular caching applications or better both of them can reap the speed benefits api keys all constants and templates are cached in apc now with more caching on tap in upcoming releases development environment this version was developed substantially within a vagrant staging environment resulting in the inevitable optimization of the state decoded to run within vagrant that involved a lot of tiny changes e g respecting port numbers in urls that collectively create a smooth experience when developing locally we have the under development vagrant configuration for the state decoded in its own repository this version and all future versions will have a vagrant machine image available for download to make it trivial to get started vagrant is working on a path to deploy vagrant machine configurations as aws instances which is why this is a bandwagon worth hopping on now standardization out with html purifier in with html tidy out with mdb2 in with pdo out with late nineties style commenting and code formatting in with pear style commenting and code formatting there was nothing wrong with any of those prior approaches but it s best to establish an environment that contributors expect that makes it easier for folks to contribute code to the project or customize it for their own website also html tidy and pdo are already installed by default on a great many systems which simplifies the setup process extensibility several steps have been made to facilitate customization all non obvious database columns are now commented there s infrastructure for inline help text stored and distributed as json and there s support for importing storing and display arbitrary metadata fields alongside the standard data about each law new features and of course we couldn t resist a few new features there s now keyboard navigation within laws and structures for those power users who want to flip through laws quickly there s baked in support for disqus based commenting on each law page just enter your site s disqus shortname in config inc php and you re up and running and finally there s bulk generation of both plain text and json versions of laws to what end dunno that s for you to figure out this release involved a lot of work over the course of four months bill hunt has scrubbed in to help as a core contributor and he s responsible for a lot of these improvements some very helpful bug reports wiki edits and pull requests came from chris birk and daniel trebbien next up versions 0 8 and 0 9 which will be released soon and close together version 0 8 will be comprised of the ui ux branch which only has a handful of small tasks remaining thanks to months of work by meticulous john athayde and lynn wallenstein and version 0 9 will be comprised of the solr bra...