The file index.html for our website, which is the main page, includes 1-line
summaries of news items at the bottom.

When we make a new release, we write a news article, add it to the "news" page
(http://uima.apache.org/news.html), and include add the 1-line summary to the
main page, as a link to the news page.

It looks like the last updates for the uima-as 2.4.0 release and the uima-cpp
2.4.0 release didn't quite do this properly.

When we update the website, we update xml files under
https://svn.apache.org/repos/asf/uima/site/trunk/uima-website/xdocs, for
instance .../xdocs/index.xml.  Then whoever is doing the updates runs the
build.xml ant script, which takes any changed files in the /xdocs/ directory and
regenerates the ....html files that correspond, under  ... docs/ directory.

Then (important step, easy to forget), you have to check into SVN both the
changed source and the changed generated files.  The changed generated files are
the actual web site pages that are displayed.

Looking at the svn history for the index.xml (source) and index.html (generated)
files, this shows:

for the index.xml source file:

  2 updates:
    rev 1410512, 11/16/12 12:59 PM by cwiklik for uima-as 2.4.0
    rev 1411905, 11/20/12  5:10 PM by bhavani for UIMA C++ 2.4.0
      But - rev 1411905, when you look at the change, instead of
      adding UIMA C++ 2.4.0, accidentally reversed the change
      done by rev 1410512 - removing the line for uima-as 2.4.0.
      You can see this in the uima commits mail, for this revision.

for the index.html generated file:

  1 update:
    rev 1411912, 11/20/12  5:28 PM by cwiklik for uima-as 2.4.0

So our actual site home page is missing at the bottom both the uima-as and
uima-cpp news links.

I'm not sure what went wrong in our process; probably several unrelated small
errors happened.  I'll open a Jira to fix this.

-Marshall

Reply via email to