[GitHub] [pulsar] jerrypeng commented on issue #4507: [Docs] Update site2/docs/functions-overview.md

[GitBox <gi...@apache.org>]

jerrypeng commented on issue #4507: [Docs] Update site2/docs/functions-overview.md
URL: https://github.com/apache/pulsar/pull/4507#issuecomment-501350076
 
 
   @Jennifer88huang using second-person pronoun is ok with me.  I just know from writing academic papers for IEEE or ACM conferences, we always use third person. I don't think I have ever read a academic paper written in second-person.  Though our documentation doesn't need to be as formal as an academic paper.
   
   > So if it refers to framework, we can use "Pulsar Functions" as plural form. 
   
   Yes
   
   > If it refer to individual functions, could we use it as "a Pulsar function"(using lowercase "f")?
   
   Yes.  In some places we use Pulsar Function (capital case "f") in other places we use Pulsar function  (lowercase "f"). We probably should be consistent throughout our documentation, though I am not sure which is more appropriate, capital case "f" or lowercase "f".
   
   Though for Azure Functions, its documentation uses a capital case "f":
   
   https://azure.microsoft.com/en-us/services/functions/
   
   Maybe we should just do that?

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services