[ 
https://issues.apache.org/jira/browse/SOLR-11646?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17434304#comment-17434304
 ] 

Ishan Chattopadhyaya commented on SOLR-11646:
---------------------------------------------

bq. if you make a list, maybe add to the existing spreadsheet another tab to 
track places, then we could both tackle this
I think you're taking a top-down approach, and this is a systematic way to 
doing this.

I'm still unclear about my overall strategy. I'm taking a bottom-up approach at 
the moment, maybe ad-hoc approach. I've started with the "getting started" 
page, and going to work my way up. For example, I just added the V2 API call 
for creating a collection there, but had to ping [~noble.paul] for the command 
as I couldn't find it anywhere else. Now, I think I can plug it into the 
collections API page. Maybe, while doing so, I'll add some other V2 examples in 
the collections API as well, and take it from there.



> Ref Guide: Update API examples to include v2 style examples
> -----------------------------------------------------------
>
>                 Key: SOLR-11646
>                 URL: https://issues.apache.org/jira/browse/SOLR-11646
>             Project: Solr
>          Issue Type: Improvement
>          Components: documentation, v2 API
>            Reporter: Cassandra Targett
>            Assignee: Cassandra Targett
>            Priority: Major
>          Time Spent: 9h
>  Remaining Estimate: 0h
>
> The Ref Guide currently only has a single page with what might be generously 
> called an overview of the v2 API added in 6.5 
> (https://lucene.apache.org/solr/guide/v2-api.html) but most of the actual 
> APIs that support the v2 approach do not show an example of using it with the 
> v2 style. A few v2-style APIs are already used as examples, but there's 
> nothing consistent.
> With this issue I'll add API input/output examples throughout the Guide. Just 
> in terms of process, my intention is to have a series of commits to the pages 
> as I work through them so we make incremental progress. I'll start by adding 
> a list of pages/APIs to this issue so the scope of the work is clear.
> Once this is done we can figure out what to do with the V2 API page itself - 
> perhaps it gets archived and replaced with another page that describes Solr's 
> APIs overall; perhaps by then we figure out something else to do with it.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org

Reply via email to