Contributing to Spring Framework Reference Documentation? - spring

I am wondering if there is a way for public to contribute to Spring Reference documentation (e.g. http://docs.spring.io/spring/docs/current/spring-framework-reference/).
I find typos occasionally.
I can't find any source code repository, or contact information.
I see CONTRIBUTING-DOCUMENTATION.adoc in the main repo, but I don't think it is the same thing? https://github.com/spring-projects/spring-framework/blob/master/CONTRIBUTING-DOCUMENTATION.adoc

Actually that is the how-to contribute to the reference guide. Tothether with the Contributing Guide that explains what you need to do and take care of when contributing.
The actual source file used for the reference guide can be found in the same repository.
The flow is basically, create a JIRA issue, fix it, create a pull request, refer to pull request from JIRA.

One way i've seen for community to help contribute is by lodging tickets on jira.spring.io.
If you provide the issue and provide answer to it they will review and give you relevant feedback on it.

Related

XD Plugin API and Components

I am trying to write an XD plugin that dynamically populates an artboard with components, but I don't see any mention of components in the XD plugin API. Is it possible to look through the file and find available components and place them on stage? Better yet, maybe even pull a component from a specific file in the cloud?
Unfortunately, it isn't possible to create symbol instances (that's what components are called in the APIs), yet. Here is the explaining quote from the plugin docs:
It is not currently possible for plugins to create a new component definition or a new SymbolInstance node, aside from using commands.duplicate to clone existing SymbolInstances.
(https://adobexdplatform.com/plugin-docs/reference/scenegraph.html#symbolinstance)
There is a feature request open for it in the official plugin developer forums which you can vote for. According to Steve Kwak (Adobe), however, this seems to be problematic due to the edit context, meaning it may still take a while until we get API access to that.
There, unfortunately, also, as of yet, isn't any way to list the available symbols for a document. For the other asset types, this is possible via the assets module (cf. https://adobexdplatform.com/plugin-docs/reference/assets.html), but not (yet) for symbols.
I hope this helps (although it's probably not the answer you've hoped for).

Creating contact folders with Outlook REST API?

Is it possible to create contact folders with Outlook REST API? I've looked into the docs for Outlook Contacts API and found only references to fetching existing contact folders (even in the beta version).
Other questions seem to focus on using C# and probably some specific SDK for that. I'm using Python, so that wouldn't work for me. I haven't found, both on StackOverflow and through Google in general, any definitive answers to this question. From the lack of any mentions in the docs, I'd assume it's not possible, but just wanted to get a definitive and/or official answer on that matter, if possible. Also please let me know if I missed something during my research.
Thanks!
There is a create folder operation, although it seems specific to Mail folders and doesn't take any parameters that can specify a folder type. It's possible it may take on the same item type as the parent folder, but I'm not certain.
Otherwise there is a create method specific for Contact folders in the Graph API; see https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/contactfolder_post_childfolders.
If you want a Python specific SDK, see: https://github.com/microsoftgraph/msgraph-sdk-python. Code samples: https://github.com/search?q=python+sample+user:microsoftgraph&type=Repositories
FYI, you can use any code platform to work with the Office 365 or Graph APIs, as long as they support REST.
After reading #Eric Legault's answer it gave me an insight to try something blindly. Even though the docs do not state it, you can create a folder by doing a POST to the contact folders endpoint with DisplayName property in the body.
So do
POST https://outlook.office.com/api/<version>/me/contactfolders with {"DisplayName": "folder_name"} in the request's body and it will work, returning the usual 201 Created response code.
This worked for me in both v2.0 and beta endpoints.
As of this writing, Outlook Contacts' UI (self-entitled Outlook People) is terrible and not user-friendly at all (either that or I just suck at understanding it), so I actually don't know how to create or delete contact folders through it, but I'm glad the REST API does the job :)

Why does the API doc for InteractsWithPages not include a lot of the functions available if you view it in the laravel/framework repo?

The official framework repo's page for InteractsWithPages has a lot of functions that the API documentation does not cover. Why is this? It's sort of made the documentation seem unreliable to me, meaning I have to go search the github every time I want more information about a certain function.
In documentation you have included only methods that are public because in most cases you will use only them.
If you need to extend any class/trait you will need to look at code so you will look at protected/private methods and their code so they don't need to be included in documentation

ASP.NET Web-API Help-API Generator?

I am wondering if anyone can point me to which Web-Api Help Generator I should use.
I found this post but it is already a year old and seems to be outdated.
I think ApiExplorer is now Web API Help.
The post also talks about Swagger which from some demos looks a lot nicer and seems like you can do like post requests and such but I am unsure if it still in development as it's been like a year since the last update.
Anyone have any experience with either of them?
The "Web API Help Page" package (Microsoft.AspNet.WebApi.HelpPage) is built on top of ApiExplorer.
Web API Help Page generates documentation pages and adds them to your project.
ApiExplorer gives you a lower-level API that just gives you the API descriptions, which you can use to create documentation.
See: http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages
I haven't used Swagger. From the readme, it's also built on top of ApiExplorer.

New settings in the Group Settings API...were these announced?

I noticed some new settings in the Google Group Settings API...were these announced? Where should we look for such announcements?
I assume you're referring to spam moderation and include in GAL? No, they weren't announced to my knowledge. Google's getting better at announcing changes but they still slip in updates like this from time to time with no way of knowing till you happen to find it buried in ref. docs.
I suggest tracking the doc pages where possible. I use ChangeDetection.com to get email notifications when reference docs get updated.
This particular change wasn't announced anywhere except for the updated reference docs. Often changes are posted to the Developer's Blog at http://googledevelopers.blogspot.com/, just not for this.

Resources