Hey all, Was doing some poking around the ref-guide this weekend. I noticed that the output snippets given with the API documentation is split about 50/50 between xml and json. Few of the examples contain an explicit "wt" parameter. With the default "wt" format switching to json in 7.0, this means that any of the output snippets in XML format won't match what a user following along would see themselves.
This won't trouble experienced users, but it could be a small speedbump for any new Solr adopters. Making the snippets match the API calls would make the docs more correct, and more amateur-friendly. There's two approaches we could take to bring things into better alignment: 1. Change all API output snippets to JSON. 2, Don't change the format of any snippets. Instead, add a "wt" parameter to the API call corresponding to any XML snippets, so that the input-call matches the output. Happy to create a JIRA and propose a patch for either approach if people think it's worth it, or have a particular preference on approach. Anyone have any thoughts? Best, Jason --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
