xml - Where to put copyright information in an XSD? -

-

when placing copyright information in xml schema definition (xsd), there official (or semi-official, universally accepted) location doing so?

based on where add version xsd schema?, there's official version attribute in xs:schema element - there similar copyright information?

i have seen people using annotation/documentation elements (e.g. here) - accepted way of doing this?

<xsd:annotation>   <xsd:documentation xml:lang="en">      copyright 2015 example.com. rights reserved.   </xsd:documentation> </xsd:annotation>

xsd has no specific, direct support copyright information. 3 methods used in practice:

  1. xml-level comments:

    <!-- copyright 2015 example.com. rights reserved. -->

    this ok may run afoul of policies preferring see documentation in proper xsd annotations. also, sure not add such line above xml declaration (<?xml version="1.0" encoding="utf-8" ?>) present in xsd keep xsd well-formed.

  2. xsd-level documentation (as mention):

    <xsd:annotation>   <xsd:documentation xml:lang="en">     copyright 2015 example.com. rights reserved.   </xsd:documentation> </xsd:annotation>

    this improves upon xml-level comments still lacking in area of semantic markup: fine human readers non-ideal automated/application processing.

  3. xsd-level appinfo markup:

    <xsd:annotation>   <xsd:appinfo>     <copyright-notice>       copyright 2015 example.com. rights reserved.     <copyright-notice>     <license uri="http://www.apache.org/licenses/license-2.0"              version="2.0">apache license, version 2.0</license>     <author>j smith</author>     <!-- ... -->   </xsd:appinfo> </xsd:annotation>

    this improves further upon generic xsd-level documentation.

these work follow first lead of established policies or conventions @ organization before embarking on new approach sort of metadata.


Comments

Post a Comment

Popular posts from this blog

yii2 - Yii 2 Running a Cron in the basic template -

-
i have seen instructions on running cron in advanced template, cant figure out how on basic template. have following controller in basic controllers folder. <?php namespace app\controllers; use yii\console\controller; /** * cron controller */ class croncontroller extends controller { public function actionindex() { echo "cron service runnning"; } public function actionmail($to) { echo "sending mail " . $to; } } i have navigated root of application , tried these comands yii cron php yii cron im getting unknown comand "cron" i know old question failed find actual answer this. if @ code yii exec file you'll notice requires /common/config/aliases.php file console/config/main.php. can naturally change these or copy on these advanced template. hope solves problem wanting same thing.
Read more

asp.net - 'System.Web.HttpContext' does not contain a definition for 'GetOwinContext' Mystery -

-
i realize question might seem trivial some, it's these types of things find myself fighting quite bit , want make sense of despite seeming losing battle in .net (for me anyway). so, if following: using system.web; ... applicationuser user = system.web.httpcontext.getowincontext().getusermanager<applicationusermanager>().findbyid(system.web.httpcontext.user.identity.getuserid()); that produces error in title , red getowincontext() , error cannot resolve symbol 'getowincontext()' however, if following (remove system.web in front of httpcontext ), works expected (or @ least no errors): using system.web; ... applicationuser user = httpcontext.getowincontext().getusermanager<applicationusermanager>().findbyid(system.web.httpcontext.user.identity.getuserid()); however, if (same line that's working using system.web commented out): //using system.web; ... applicationuser user = httpcontext.getowincontext().getusermana...
Read more

mercurial graft feature, can it copy? -

-
there new feature in mercurial 3, called 'graft' (graft local). job of moving change-set different branch. is there way "copy" change-set branch? i interested in in moving stuff qa branch production branch, still need code reside in qa. want copy. found , have tried few things, maybe it'll become clear more tinkering , reading... does have better way of 'cherry picking' change-sets move cross branch (or trunk)??? graft copies changesets, doesn't move them. hg graft (emphasis mine): this command uses mercurial's merge logic copy individual changes other branches without merging branches in history graph. known 'backporting' or 'cherry-picking' . default, graft copy user, date, , description source changesets.
Read more