Add support for "documented_in" annotation in json api schema

chrome/common/extensions/docs/server2/reference_resolver.py

 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 from copy import deepcopy
 import logging
 import re
 
 from file_system import FileNotFoundError
 
@@ skipping 96 matching lines @@
               name = name_as_prop_type
               text = ref.replace(prop['name'], prop['link']['name'])
               break
         if node_info is None:
           continue
       else:
         text = ref
       category, node_name = node_info
       if namespace is not None and text.startswith('%s.' % namespace):
         text = text[len('%s.' % namespace):]
+      api_namespace = self._api_models.GetModel(api_name).Get()

[not at google - send to devlin, 2014/03/26 22:11:11]

api_model

also this .Get() will be interesting, hopefully it won't slow things down too
much. I guess we'll see.

+      api_name = api_namespace.documentation_options.get('documented_in',

[not at google - send to devlin, 2014/03/26 22:11:11]

|api_name| is not a correct way to refer to this. perhaps

api_model = ...
filename = api_model.documentation_options.get(
    'documented_in', api_name)

+          api_name)
       return {
         'href': '%s.html#%s-%s' % (api_name, category, name.replace('.', '-')),

[not at google - send to devlin, 2014/03/26 22:11:11]

we can drop the .html from these now, actually. could you do that file-wide?

         'text': text,
         'name': node_name
       }
 
     # If it's not a reference to an API node it might just be a reference to an
     # API. Check this last so that links within APIs take precedence over links
     # to other APIs.
     if ref in api_list:
       return {
         'href': '%s.html' % ref,
@@ skipping 79 matching lines @@
           ref = ''
           rest = ref_and_rest
         else:
           ref = match.group()
           rest = ref_and_rest[match.end():]
 
       ref_dict = self.SafeGetLink(ref, namespace=namespace, title=title)
       formatted_text.append('<a href="%s%s">%s</a>%s' %
           (link_prefix, ref_dict['href'], ref_dict['text'], rest))
     return ''.join(formatted_text)