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

ASF subversion and git services commented on GEODE-1525:
--------------------------------------------------------

Commit fb75348a3ded7fddb45424956cd946cf13b5a20b in incubator-geode's branch 
refs/heads/develop from [~karensmolermiller]
[ https://git-wip-us.apache.org/repos/asf?p=incubator-geode.git;h=fb75348 ]

GEODE-1525: Examples README.md should set env variable
GEODE-1523: Improve examples README.md markdown

This PR fixes addresses both GEODE-1525 and GEODE-1523, as they
both change the contents of the same file: geode-examples/README.md.

- Each example will likely use a scripts/setEnv.sh script to set
  the path to gfsh. The script depends on a GEODE_HOME environment
  variable, so this top level of instructions for setting up
  the examples now tells the user to set a GEODE_HOME env variable
  directly after the installation.

- Implement a more strict markdown that displays correctly for a
  wide variety of markdown implementations.

- Put in links for the 3 references.

- Improve the prose.


> geode-examples rely on GEODE_HOME env variable
> ----------------------------------------------
>
>                 Key: GEODE-1525
>                 URL: https://issues.apache.org/jira/browse/GEODE-1525
>             Project: Geode
>          Issue Type: Bug
>          Components: docs
>            Reporter: Karen Smoler Miller
>            Assignee: Karen Smoler Miller
>              Labels: bug-hunt
>
> Work currently on the feature/GEODE-33 branch.
> The script {{setEnv.sh}} in the first example (Replicated Region) relies on 
> the user setting the environment variable, {{GEODE_HOME}}, in order to invoke 
> gfsh.  This is fine, and the script would fail, telling the user to set the 
> variable. So, things work.  
> However, it is likely that many examples will want this same env variable 
> set. Therefore, the top level {{README.md}} should contain a step, perhaps 
> directly after the link to the installation instructions that directs a user 
> to set a {{GEODE_HOME}} environment variable.
> Then, as more examples are added, they can copy the Replicated Region's 
> {{setEnv.sh}} script and also use it.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to